凹库 是“凹语言资料库”的简称,用于社区资料搜集、讨论汇总。
克隆本仓库至本地或在线浏览。
目录为分类版块,子目录为子版块,目录下的 .md
文件为属于该版块的资料帖。所有名为 res
的目录为保留目录,用于存放本版块下帖子的外部引用文件。
waku
|- 决策委员会(Board)-------决策委员会公开信息
|
|- 开发组(Dev)-------------凹语言项目的开发
| |- 包(Package)----------功能包
| |- 编译器(Compiler)-----编译器
| |- 应用(App)------------凹语言应用程序
| |- 运行环境(Env)--------程序运行环境,如 Playground 等框架
| |- 综合讨论(Common)-----日常开发讨论、开发管理
|
|- 用户组(User)------------凹语言使用
| |- 进阶使用-------------进阶技巧
| |- 新手入门-------------入门使用及问答
| |- 综合讨论-------------日常使用讨论、及无法归类的内容
|
|- 站务--------------------凹库站务
|- 灌水
|- 新人报到-------------新人自我介绍
|- 站务讨论-------------凹库功能讨论、建站提议
您可以在已有板块下发起新增资料贴的 pr,资料贴必须为 .md
文件。假设新增的资料贴名为 linkname标签作用.md
,其中引用了图片等外部文件,那么需在资料贴所在目录的 res
子目录下建立名为 linkname标签作用
的子目录,并将外部文件置于其中同步提起 pr。资料贴的文件名应该是其内容的梗概,形如 xxx.md
这样无法一眼看出内容的 pr 将不会被接受。
您可以对已有的资料贴进行增补,哪怕该贴并非由您创建。资料贴内部以树形结构存储主贴、回帖,回帖可嵌套,形如:
## 赵小二
原帖内容
***
> ## 张三
> 回帖内容
> ***
>
>> ## 王五
>> 回帖的回帖1
>> ***
>>
>> ## 李四
>> 回帖的回帖2
>> ***
>>
帖子间的递进关系以引用符号 >
确定,N 级回帖每行前有 N 个 >
,对某个帖子的回帖,视为该帖子的一部分,由于符号 >
的该特定含义,因此帖子内容中不可再使用它,以免引起从属错误。
除行首符号 >
外:帖子的头部应为单行 ## 昵称
,尾部应为单行分割线 ***
,除此之外,各级别的 #
标题符号,分割线符号 ---
、***
、___
不应出现在帖子的其余部分。在帖子内容中,列表符1.
和-
、制表符、粗体符、斜体符、图片引用均可使用。为了让社区能熟悉您,我们建议您在选定昵称后尽量不要随意变更。
为了让您的回帖更容易被看见,建议您回复时,在紧贴被回复帖子的正文结束处插入(既在帖子的子贴列表的头部插入)。特别需要注意的是:您只能新增回帖,若 pr 删除或修改了资料贴的其它部分,该 pr 不会被接受。该规则意味着无论是您创建的资料贴、还是您增补的评论,pr 一旦通过,提交的内容将无法修改。该规则对资料贴引用的外部文件同样有效,既:您不能修改或删除已有的外部引用文件,因此当您的 pr 中包含引用文件时,请特别注意不要与已有文件重名。
总结:
- 只增不删,贴名为标题
- 资源文件位于同级
res
下的同贴名目录下 >
用于确定帖子递进关系- 首行
## 昵称
,尾行***
- 通过预览检查格式是否正确
- 请不要提交我们面对面交流时您不会说的那些话;
- 尽量提供有建设性的内容;
- 尝试提交违法信息可能将您和我们带入险境;
- 当您对内容的格式有拿不准的地方时,请参考已有的帖子。