# manpages_zh **Repository Path**: yanpenn/manpages_zh ## Basic Information - **Project Name**: manpages_zh - **Description**: 基于列数的中文manpages手册 - **Primary Language**: XSLT - **License**: Not specified - **Default Branch**: master - **Homepage**: http://intetnet.github.io - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2015-03-21 - **Last Updated**: 2020-12-19 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README #基于列数的中文manpages手册 我希望借助开放和互助来持久的进行这个计划，在这个计划里没有什么限制，你可 以以你喜欢的方式工作，发布你喜欢的内容。只有在有一个起点的情况下，更多的 人才能够参与进来。 ##中文manpages 中文manpages显然需要长久的维护，不仅现在留下来的上万的文档需要整理，程序 本身也在推陈出新，所以我希望更多的人能够参与进来，来维护一个长久更新，切 实能用的中文manpages,我本身非常乐观，因为我们现在有比之前更好更多的资源 ，我使用ronn将兼容于markdown的ronn-format文件转换为漂亮的man手册，这个过 程也比之前那些项目要来的方便快捷，但你不用理会这个过程，你只需提交你的作 品，或者帮助改善中文文档，这些都是没有任何门槛的。 在man中显示汉字与英语杂排总是会有拉伸，同一个文件在每个人的显示屏上最终 显示效果也不同，为了解决这个问题，以前的中文manpages项目讨论过解决办法， 一种是采用固定列数的办法，manpages仅为这一种列数优化，在这种列数下显示一 般是正常的，其他列数下则有可能发生单词拉伸。还有一种办法就是每个汉字之间 放一个空格，把汉字当做英文单词来排版，这样做的缺点是不规范，也不好看。本 项目采用第一种方法，这样至少可以在特定列下显示是完整好看的。 ##项目结构 中文有简体和繁体,因此对应的manpages手册也分为简体和繁体,通常简体和繁体文 档应该是同步的,因此都放在了`man/`下,由man根据系统的locale或调用man的参数 来决定如何显示,参考`wiki/man简介`. 不同的用户可能使用不同的系统,通常大多数软件应该是一样的,都会跟着上游升级 ,只是有些和系统相关的软件仍需要特殊的处理,这里使用特定的分支来解决这个问 题,例如使用archlinux,ubuntu,fedora分支等等,如果相同系统的不同版本使用不 同的手册,就继续细分该系统,比如ubuntu10.04分支.本项目的分支还用于文件交流 和协同翻译. master主分支会一直跟踪上游,因此总是最新的,因此您clone到本地后可能需要切 换分支.针对系统发布打包好的文件也是我们努力的目标. `man/`下是可以直接使用的中文manpages文档，`html/`下是中文manpages文档的 网页文件，`ronn/`下是用来生成man文档和网页的原始文件，`source/`下是翻译 前可供参考的文件，里面有LCTT计划和CMPP项目留下来的一些文件，您可以在此文 件夹下设置自己的工作目录.编辑显示和帮助请参考`wiki/`。 本项目在Github:。 本项目在Git@OSC: 在线manpages文件可以在上查看。 ##怎么安装？ manpages为文本文件，是不需要安装的。man使用特定的文件结构，类似于 `/home/youname/man/zh_CN/man1/man.1`这样子，你把下载的manpages手册放在硬 盘上你心仪的位置，然后保证manpath能找到即可。manpath可以通过设置环境变量 来实现，如果你使用的是bash,并且把本项目clone在用户根目录下manpages文件夹 ,那么你可以在`.bashrc`加入下面语句： export MANPATH=/usr/man:/usr/share/man:～/manpages/man/ 不同的文件夹间使用分号隔开。 更多请参考`wiki/`文件夹。 ##加入我们 如果您希望将你的作品发表在此，您可以加入本项目.通常推荐的方式是folk项目, 然后推送更新,或者提醒我添加远程仓库.您也可以加入到本项目里面来,在Github 或者Git@OSC发一个issue或者给我发一封电子邮件就可以了,您现在可以看一下我 们的协调计划. 我需要你的帮助来完善版权信息和改善中文手册。 ##联系我 你可以发送电子邮件到yanpenn@outlook.com。 ##todo 短期计划参考TODO,长期计划参考`plan/`文件夹. ##版权 请参考COPYRIGHT