diff --git a/publish.sh b/publish.sh index f756ff6..8486760 100755 --- a/publish.sh +++ b/publish.sh @@ -28,7 +28,7 @@ org-html-postamble t org-html-postamble-format `(("en" ,(get-postamble ".")) - ("zh-CN" ,(get-postamble "zh_CN")))) + ("zh-CN" ,(get-postamble "zh-CN")))) (dolist (org-file (directory-files-recursively default-directory "\\.org$")) (let ((html-file (concat (file-name-directory org-file) diff --git a/zh-CN/features.org b/zh-CN/features.org index 79ab8f7..0367040 100644 --- a/zh-CN/features.org +++ b/zh-CN/features.org @@ -62,7 +62,7 @@ Org 里最基础的结构是由可嵌套、可折叠的章节构成的树。你 Org 的树结构给用户带来了快速且优雅的导引与强大的信息遮避功能，让你在保持获取需要信息的能力的同时专心于手头的任务。 -控制章节可见与否只是 Org 的一个小小的功能，而 Org 仍有其它多种工具与命令来为纯文本结构化的编辑带来便利。 Org 的语法让用户把枯燥的任务变成了单个的键盘命令，让用户更着重于内容而不是形式。 +控制章节可见与否只是 Org 的一个小小的功能，而 Org 仍有其它多种工具与命令来为结构化地编辑纯文本带来便利。 Org 的语法让用户把枯燥的任务变成了单个的键盘命令，让用户更着重于内容而不是形式。 *** 更多 @@ -123,7 +123,7 @@ Org 目前支持超过[[file:../worg/org-contrib/babel/languages/index.html][80 Worg（英语）：[[file:../worg/org-contrib/babel/languages/index.html][支持语言]]列表 -* 导出与发表 +* 导出与发布 :PROPERTIES: :CUSTOM_ID: publishing :HTML_CONTAINER_CLASS: side-fig @@ -135,7 +135,7 @@ Worg（英语）：[[file:../worg/org-contrib/babel/languages/index.html][支持 ** 描述 -Org 是一个撰写与发表的工具 ----- 它既可以是静态网页生成器，也可以是一系列为发表内容提供便利的工具。 +Org 是一个撰写与发布的工具 ----- 它既可以是静态网页生成器，也可以是一系列为发布内容提供便利的工具。 你使用 Org 的简洁易懂的标记语法来撰写稿件，然后导出到你所选择的任何一种格式。 Org 支持很多格式，其中包含： @@ -146,15 +146,15 @@ Org 是一个撰写与发表的工具 ----- 它既可以是静态网页生成器 开发者可以轻松地为任何格式创造新的导出后端（详见[[file:../worg/dev/org-export-reference.html][ox的文档]]),并且 Org 也被[[https://pandoc.org][Pandoc]]支持。 -除开导出单一的文件以外，你还可以​/发表项目/ ----- 将一个或更多的 =.org= 文件以及其需要的各种资源导出到一个或更多的发表后端。 +除开导出单一的文件以外，你还可以​/发布项目/ ----- 将一个或更多的 =.org= 文件以及其需要的各种资源导出到一个或更多的发布后端。 *** 更多 冷知识：Org 的网页是由 Org 编写而成！ -详见手册（英语）：[[file:../manual/Markup-for-Rich-Contents.html][标记]]，[[file:../manual/Exporting.html][导出]]，[[file:../manual/Publishing.html][发表]] +详见手册（英语）：[[file:../manual/Markup-for-Rich-Contents.html][标记]]，[[file:../manual/Exporting.html][导出]]，[[file:../manual/Publishing.html][发布]] -Worg 教程（英语）：发表到 [[file:../worg/org-tutorials/org-publish-html-tutorial.html][HTML]] ；发表到 [[file:../worg/org-tutorials/org-latex-export.html][\(\LaTeX\)]] +Worg 教程（英语）：发布到 [[file:../worg/org-tutorials/org-publish-html-tutorial.html][HTML]] ；发布到 [[file:../worg/org-tutorials/org-latex-export.html][\(\LaTeX\)]] * 把握任务的进程 :PROPERTIES: @@ -169,11 +169,11 @@ Worg 教程（英语）：发表到 [[file:../worg/org-tutorials/org-publish-htm Org 是一个功能齐全的任务计划工具、时间管理工具以及待办事项工具。 -任何一个章节都可以通过增加例如 =TODO= 或者 =HOLD= 等关键词来被设置成​/待办/​。你可以由此跟踪纪录此任务的进度。你也可以使用快捷键 =S-= 和 =S-= 来把任务切换到不同状态。 +任何一个章节都可以通过增加例如 =TODO= 或者 =HOLD= 等关键词来被设置成​/待办事项/​。你可以由此跟踪纪录此任务的进度。你也可以使用快捷键 =S-= 和 =S-= 来把任务切换到不同状态。 需要增加其他的任务状态？没问题。你可以根据你的工作流程自由地设置任务状态。 -在 Org /日程/​（Agenda）里，你可以轻松地查看多个文件里的任务 ----- 你仅需要添加一个任务状态关键词，例如 =TODO=​。Org 为以下功能有内置支持：任务优先级、截止日期、计划中任务、标签、打卡等等。​/日程/​能够使用上述所有功能来整理任务以及设置优先级。因此，在仅仅使用纯文本标记的同时，你可以把一个简单的待办事项列表无缝升级为一个完整的项目管理软件。 +在 Org /日程/​（Agenda）里，你可以轻松地查看多个文件里的任务 ----- 你仅需要添加一个任务状态关键词，例如 =TODO=​。Org 为以下功能有内置支持：任务优先级、截止日期、计划中任务、标签、打卡等等。​/日程/​能够使用上述所有功能来整理任务以及设置优先级。因此，在仅需使用纯文本标记的同时，你可以把一个简单的待办事项列表无缝升级为一个完整的项目管理软件。 *** 更多 diff --git a/zh-CN/index.org b/zh-CN/index.org index 1397a37..b5da846 100644 --- a/zh-CN/index.org +++ b/zh-CN/index.org @@ -1,7 +1,7 @@ #+title: Emacs 的 Org 主模式 #+setupfile: setup.org -#+html_head: -#+html_head: +#+html_head: +#+html_head: #+include: "resources/preamble.html" export html #+html_head: @@ -13,13 +13,13 @@ alt="Org unicorn logo" itemprop="image"/>

- Org Mode + Org 主模式

纯文本的生活

一个 GNU Emacs - 的纯文本主模式。Org Mode 有多种用法：用户可用它来快捷且高效地记笔记、编写文档、计算笔记本、文学编程、维护待办事项、计划项目等等。

+ 的纯文本主模式。Org 有多种用法：用户可用它来快捷且高效地记笔记、编写文档、计算笔记本、文学编程、维护待办事项、计划项目等等。

从 GNU ELPA 下载 如何报告问题 给 Org Mode 邮件列表发送邮件 @@ -33,16 +33,16 @@ - +

#+end_export @@ -128,7 +128,7 @@ Org 的用法五花八门，因此我们无法把它们轻松地纪录下来， - [[file:../worg/org-in-the-wild.html][野生的 Org]] - /……以及更多/ -[[file:../worg/][Worg]]是一个装有 Org 文件的 Git 代码仓库，发步为 HTML 网页，[[file:../worg/worg-about.html#contribute-to-worg][欢迎贡献]]。 +[[file:../worg/][Worg]]是一个装有 Org 文件的 Git 代码仓库，发布为 HTML 网页，[[file:../worg/worg-about.html#contribute-to-worg][欢迎贡献]]。 #+BEGIN_SRC shell ~$ git clone https://git.sr.ht/~bzg/worg @@ -147,6 +147,8 @@ Org 邮件列表是一个能与整个 Org 社区交流的地方。你可以[[htt 你也可以使用 IRC 在[[https://libera.chat/][Libera.Chat]]的 ~#org-mode~ 频道上与其它 Org 爱好者交流。​_请注意，此频道需要使用英语交流。_ +[[https://emacs-china.org][Emacs China]]是一个中文 Emacs 用户聚集的论坛。在此你可以讨论 Org 以及其他与 Emacs 相关的内容。​_请注意，此论坛需要使用中文交流。_ + Org 的完整贡献者列表在 /Worg/ 里[[file:../worg/contributors.html][可见（英语）]]。你也可以查看手册的[[file:../org.html#History-and-Acknowledgments][鸣谢（英语）]]。 * Doom，Spacemacs，Scimax以及热门配置 @@ -154,7 +156,7 @@ Org 的完整贡献者列表在 /Worg/ 里[[file:../worg/contributors.html][可 :CUSTOM_ID: configs :END: -[[https://github.com/hlissner/doom-emacs][Doom]]，[[https://www.spacemacs.org/][Spacemacs]]，以及[[https://github.com/jkitchin/scimax][Scimax]]这几个 Emacs 入门工具包包含了一系列经过精细管理过的组件与配置，目标是给常用的 Org（以及 Emacs 本身）用法带来优化。它们包含了 =org-mode= 与其它模式的集成（例如 =evil-mode=​）。这里是它们目前使用的组件列表：[[https://github.com/hlissner/doom-emacs/blob/develop/modules/lang/org/packages.el][Doom]]、[[https://github.com/syl20bnr/spacemacs/blob/master/layers/%2Bemacs/org/packages.el][Spacemacs]]。​/Scimax/ 与 Org 紧密集成，所以 /Scimax/ 用户应先参考它的[[https://github.com/jkitchin/scimax/blob/master/scimax.org#org-mode][手册（英语）]]。​/Doom/ 使用的 Org 版本接近与开发版 ~HEAD~​，而 /Spacemacs/ 与 /Scimax/ 使用的则是 Org 在 GNU ELPA 上发步的版本。 +[[https://github.com/hlissner/doom-emacs][Doom]]，[[https://www.spacemacs.org/][Spacemacs]]，以及[[https://github.com/jkitchin/scimax][Scimax]]这几个 Emacs 入门工具包包含了一系列经过精细管理过的组件与配置，目标是给常用的 Org（以及 Emacs 本身）用法带来优化。它们包含了 =org-mode= 与其它模式的集成（例如 =evil-mode=​）。这里是它们目前使用的组件列表：[[https://github.com/hlissner/doom-emacs/blob/develop/modules/lang/org/packages.el][Doom]]、[[https://github.com/syl20bnr/spacemacs/blob/master/layers/%2Bemacs/org/packages.el][Spacemacs]]。​/Scimax/ 与 Org 紧密集成，所以 /Scimax/ 用户应先参考它的[[https://github.com/jkitchin/scimax/blob/master/scimax.org#org-mode][手册（英语）]]。​/Doom/ 使用的 Org 版本接近与开发版 ~HEAD~​，而 /Spacemacs/ 与 /Scimax/ 使用的则是 Org 在 GNU ELPA 上发布的版本。 各种入门工具包通常大量修改了 Emacs 的默认用户设置。如果你更偏向于原版 Emacs，可以参考包含配置了 Org 及其关联组件的热门配置，例如 [[https://github.com/purcell/emacs.d/blob/master/lisp/init-org.el][Purcell 的 emacs.d]]。 diff --git a/zh-CN/manuals.org b/zh-CN/manuals.org index 0d38acc..aaed859 100644 --- a/zh-CN/manuals.org +++ b/zh-CN/manuals.org @@ -10,9 +10,9 @@ Org 手册是介绍 Org 核心功能的一个全面的官方资源。 - 作为 [[file:../manual/][多个 HTML 网页]] - 作为 [[file:../org.pdf][一个 PDF 文档]] -* Org 精简介绍 +* Org 指南 -Org 精简介绍更简洁地介绍了 Org 的主要功能。 +Org 指南更简洁地介绍了 Org 的主要功能。 - 作为 [[file:../orgguide.html][单一 HTML 网页]] - 作为 [[file:../guide/][多个 HTML 网页]] @@ -26,6 +26,6 @@ Org 精简介绍更简洁地介绍了 Org 的主要功能。 * GNU Emacs 内置 Org 手册 -GNU Emacs 负责发步其内置组件的手册，包括 Org 的手册。 +GNU Emacs 负责发布其内置组件的手册，包括 Org 的手册。 你可在[[https://www.gnu.org/software/emacs/manual/org.html][此处]]查看 GNU Emacs 的 Org 手册。 diff --git a/zh-CN/org-demo.html b/zh-CN/org-demo.html deleted file mode 120000 index 8d180cf..0000000 --- a/zh-CN/org-demo.html +++ /dev/null @@ -1 +0,0 @@ -../org-demo.html \ No newline at end of file diff --git a/zh-CN/org-demo.html b/zh-CN/org-demo.html new file mode 100644 index 0000000..9845276 --- /dev/null +++ b/zh-CN/org-demo.html @@ -0,0 +1,132 @@ +
+ 元数据 + 
+#+title:  Example Org File
+#+author: TEC
+#+date:   2020-10-27
+
+ + +

概述显示

+ 章节标题与折叠让结构化编辑小菜一碟。 + 纯文本使得将 Org 文件同步或者加入版本管理十分容易。 + + 
* Revamp orgmode.org website
+ + +

日程

+ 列出你所有文件中的待办事项。 + 过滤内容，并且直接更改其内容。 + + 
+
+The /beauty/ of org *must* be shared.
+
+ + 
[[https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg]]
+ + share icon +
+
+ + 
** DONE Make screenshots
+ + 
   CLOSED: [2020-09-03 Thu 18:24]
+
+
+
+
+ + 
** DONE Restyle Site CSS
+ + 
+
+Go through [[file:style.scss][stylesheet]]
+
+
+
+ + + + + + + +
+ + 
** TODO Check CSS on main pages
+ + 
+
+
+
+
+
+
+
+
+
+
+
+
+ + 文本 + 
* Learn Org
+ + 
+
+Org makes easy things trivial and complex things practical.
+
+You don't need to learn Org before using Org: read the quickstart
+page and you should be good to go.  If you need more, Org will be
+here for you as well: dive into the manual and join the community!
+
+
+ + 
** Feedback
+ + 
+
+#+include: "other/feedback.org*manual" :only-contents t
+
+
+
+ + 
+* Check CSS minification ratios
+
+ + +

Babel

+ 在 Org 里进行文学编程。 + 用的是缓存区里类似笔记本的实时代码运行功能。 + + 代码 +
+ 
#+begin_src python
 + 
+from pathlib import Path
+cssRatios = []
+for css_min in Path("resources/style").glob("*.min.css"):
+    css = css_min.with_suffix('').with_suffix('.css')
+    cssRatios.append([css.name,
+    "{:.0f}% minified ({:4.1f} KiB)".format( 100 *
+                      css_min.stat().st_size / css.stat().st_size,
+                      css_min.stat().st_size / 1000)])
+return cssRatios
+
+ 
#+end_src
+
+
+ + 运行结果 + 
#+RESULTS:
+ + 
| index.css    | 76% minified ( 1.4 KiB) |
+| org-demo.css | 77% minified ( 2.8 KiB) |
+| errors.css   | 74% minified ( 4.9 KiB) |
+| org.css      | 75% minified (10.7 KiB) |
+
+
+
+
diff --git a/zh-CN/quickstart.org b/zh-CN/quickstart.org index db229d4..4470d23 100644 --- a/zh-CN/quickstart.org +++ b/zh-CN/quickstart.org @@ -7,7 +7,7 @@ :CUSTOM_ID: getting-started :END: -简单来说，Org 与任何其它的标记语言一样：你可以在任何文本编辑器里使用 [[file:../worg/dev/org-syntax.html][Org 语法]] 编辑文档。 +简单来说，Org 与任何其它的标记语言一样：你可以在任何文本编辑器里使用[[file:../worg/dev/org-syntax.html][Org 语法]]编辑文档。 然而，为了体验 Org 全部的潜力，你需要一个能够把 Org 语法转换为一个可互动文档的编辑器。 @@ -250,6 +250,6 @@ _中文用户_​：​=@@comment:行内注释@@=​两侧需要使用零宽空 :CUSTOM_ID: next-steps :END: -在寻找某一个话题？试着读读[[file:../manual/][手册（英语）]]（[[file:../org.pdf][PDF]]）吧。 +在寻找某一个话题？试着读读[[file:../manual/][手册]]（[[file:../org.pdf][PDF]]）吧。 -在寻找这个快速开始与手册之间的内容？试试[[file:../guide/][指导（英语）]]（[[file:../orgguide.pdf][PDF]]）吧。 +在寻找这个快速开始与手册之间的内容？试试[[file:../guide/][指南]]（[[file:../orgguide.pdf][PDF]]）吧。 diff --git a/zh-CN/resources/postamble.html b/zh-CN/resources/postamble.html index ba8fa12..3c0aab7 100644 --- a/zh-CN/resources/postamble.html +++ b/zh-CN/resources/postamble.html @@ -8,8 +8,8 @@ style="height:1.5em; margin-bottom:-0.3em; opacity:0.9;" title="Conquer the world with Org 😉"/> 完成。

-

由 +

根据 GNU FDL 1.3授权 + title="GNU Free Documentation License version 1.3">GNU FDL 1.3 授权 — 本网页源代码见此。

diff --git a/zh-CN/tools.org b/zh-CN/tools.org index ed273ee..0a0c818 100644 --- a/zh-CN/tools.org +++ b/zh-CN/tools.org @@ -37,7 +37,7 @@ 瑞士军刀级别的 markup 文档转换器：它能将文档在不同格式之间自由转换，包括 Org。 {{{end-link}}} -* 发步 +* 发布 :PROPERTIES: :HTML_CONTAINER_CLASS: columns :END: @@ -63,7 +63,7 @@ {{{gh(org2blog/org2blog)}}} # [[https://raw.githubusercontent.com/org2blog/org2blog/master/svg/Org2Blog_shorthand.svg]] -使用 Org 编写，然后在 WordPress 上发表博客。 +使用 Org 编写博客，然后将其发布在 WordPress 上。 {{{end-link}}} * 工具 :PROPERTIES: @@ -104,7 +104,7 @@ {{{link(bitbucket.org/joebo/pico-org/src)}}} [[https://upload.wikimedia.org/wikipedia/commons/4/40/PicoLisp_Logo.svg]] -/pico-org/ --- 一个小的 Org 解析库，可以将 Org 文件内容解析成 Pico Lisp 数据解构。 +/pico-org/ ----- 一个小的 Org 解析库，可以将 Org 文件内容解析成 Pico Lisp 数据解构。 {{{end-link}}} ** Common Lisp {{{link(common-lisp.net/project/cl-org-mode/)}}} @@ -156,7 +156,7 @@ {{{link(www.drupal.org/project/orgmode)}}} [[https://www.drupal.org/files/EL_blue_RGB%281%29.png]] -一个 drupal 库，可以导入 Org 文件，例如文章，然后转换为 drupal 结点。 +一个 drupal 库，可以导入 Org 文件（例如文章），然后转换为 drupal 结点。 {{{end-link}}} ** Pandoc {{{gh(kawabata/ox-pandoc)}}} @@ -171,7 +171,7 @@ {{{link(ox-hugo.scripter.co)}}} [[https://upload.wikimedia.org/wikipedia/commons/4/48/Markdown-mark.svg]] -支持导出到兼容 Hugo 的 Markdown 格式 （黑色星期五 --- Blackfriday）。此格式相比通常的 Markdown 格式更为灵活。 +支持导出到兼容 Hugo 的 Markdown 格式（黑色星期五 --- Blackfriday）。此格式相比通常的 Markdown 格式更为灵活。 {{{end-link}}} ** ox-⁎ [[https://static.thenounproject.com/png/608341-200.png]]