Skip to content

wa-lang/waku

Repository files navigation

凹库凹库!

凹库 是“凹语言资料库”的简称,用于社区资料搜集、讨论汇总。


如何阅读

克隆本仓库至本地或在线浏览。

目录为分类版块,子目录为子版块,目录下的 .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 下的同贴名目录下
  • > 用于确定帖子递进关系
  • 首行 ## 昵称,尾行 ***
  • 通过预览检查格式是否正确

基本礼仪

  • 请不要提交我们面对面交流时您不会说的那些话;
  • 尽量提供有建设性的内容;
  • 尝试提交违法信息可能将您和我们带入险境;
  • 当您对内容的格式有拿不准的地方时,请参考已有的帖子。

About

凹库 - “凹语言资料库”的简称,用于社区资料搜集、讨论汇总

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •