From 517b07a51dd54ed42fa13ab85c78d56494bed1ce Mon Sep 17 00:00:00 2001 From: Ruijie Yu Date: Tue, 11 Apr 2023 01:32:26 +0800 Subject: [PATCH 07/16] * zh-CN/index.org: zh-CN translation --- zh-CN/index.org | 189 +++++++++++++++++++----------------------------- 1 file changed, 74 insertions(+), 115 deletions(-) diff --git a/zh-CN/index.org b/zh-CN/index.org index 6048934..b5da846 100644 --- a/zh-CN/index.org +++ b/zh-CN/index.org @@ -1,40 +1,35 @@ -#+title: Org mode for Emacs +#+title: Emacs 的 Org 主模式 #+setupfile: setup.org -#+description: Org: an Emacs Mode for Notes, Planning and Authoring -#+html_head: -#+html_head: -#+include: "./resources/preamble.html" export html +#+html_head: +#+html_head: +#+include: "resources/preamble.html" export html -#+html_head: -#+include: "./resources/normal-outline-3.html" export html +#+html_head: +#+include: "resources/normal-outline-3.html" export html #+begin_export html #+end_export -* Highlights +* 主要亮点 :PROPERTIES: :HTML_CONTAINER_CLASS: columns no-heading :END: -** Features +** 功能 @@html:@@ - #+attr_html: :alt Three stars :title Delve into the possibilities + #+attr_html: :alt 三颗星星 :title 无尽可能 [[file:resources/img/stars.svg]] @@html:@@ -** Install - @@html:@@ - #+attr_html: :alt Downwards facing arrow :title What are you waiting for? +** 安装 + @@html:@@ + #+attr_html: :alt 下箭头 :title 你还在等什么？ [[file:resources/img/install.svg]] @@html:@@ -** Quickstart +** 快速开始 @@html:@@ - #+attr_html: :alt Running stickfigure :title Start using Org. You'll never stop. + #+attr_html: :alt 火箭 :title 立即开始，你会爱上它。 [[file:resources/img/quickstart.svg]] @@html:@@ -** Contribute - @@html:@@ - #+attr_html: :alt Git branch symbol :title Yes. Do this. +** 贡献 + @@html:@@ + #+attr_html: :alt Git branch 图标 :title 多多益善。 [[file:resources/img/contribute.svg]] @@html:@@ * Elaboration + demo image :ignore: - #+attr_html: :style margin-top:2rem; - Org is a highly flexible structured plain text file format, composed - of a few simple, yet versatile, structures --- constructed to be both - [[https://karl-voit.at/2017/09/23/orgmode-as-markup-only/][simple enough for the novice]] and [[http://howardism.org/Technical/Emacs/literate-devops.html][powerful enough for the expert]]. +#+attr_html: :style margin-top:2rem; - Get a glimpse of the expressive power Org offers in the example below. - Click the headings and links to discover how Org intelligently folds structural content. +Org 是一个非常灵活的有结构的纯文本文件格式，由几种简单而又多用的结构组成。因此，Org 即足够[[https://karl-voit.at/2017/09/23/orgmode-as-markup-only/][简单]]，又足够[[http://howardism.org/Technical/Emacs/literate-devops.html][强大]]。 - #+include: org-demo.html export html +请在以下这个例子里一窥 Org 具有的强大功能。点击段落标题与链接可以智能折叠与展开相应内容。 -* Further reading +#+include: org-demo.html export html + +* 更多资料 :PROPERTIES: :CUSTOM_ID: reading :END: -Beyond the [[file:quickstart.org][quickstart]] and the [[file:manual/index.html][manual]], Org has a [[file:guide/index.html][guide]] and a wealth of -community-written documentation on [[https://orgmode.org/worg/][Worg]] . +除开[[file:quickstart.org][快速开始]]与[[file:../manual/][手册]]之外，Org 还有一个[[file:../guide/][指南]]和大量由社区编写的文档：[[file:../worg/][Worg]]。 -Nearly every Org user has a story to tell about how Org enables and -empowers them --- some have found it so useful that they have written -[[https://orgmode.org/worg/org-papers.html][(scientific) papers]] about the value of Org for conducting [[https://en.wikipedia.org/wiki/Reproducibility#Reproducible_research][reproducible -research]]. Some have produced third party tools to enjoy Org outside of -Emacs, such as mobile applications. +几乎所有的 Org 用户都有自己关于 Org 的故事 － 有些人甚至撰写了关于 Org 对于其实现[[https://en.wikipedia.org/wiki/Reproducibility#Reproducible_research][可重复性研究（英语；外网）]]价值的[[file:../worg/org-papers.html][科学论文]]。还有些人开发了一系列第三方工具用来在 Emacs 以外的环境里使用 Org ，例如在移动设备上。 -* More Org +* 更多 Org :PROPERTIES: :CUSTOM_ID: more :END: -The /de facto/ mimetype for Org files is =text/org=. Org files use the -~.org~ extension. Most operating systems don't know to open ~.org~ files -in Emacs, but they can be configured to do so without much effort. +Org 文件的 MIME 类型为 =text/org=​，使用 ~.org~ 后缀名。大部分操作系统不知道应该使用 Emacs 来打开 ~.org~ 文件，但通常可以轻松修改其对应设置来达到此目的。 -While the reference implementation of Org in Emacs lisp is by far the -most featureful, there are many additional [[file:tools.org][tools]] that work with Org. +Org 在 Emacs Lisp 上的默认实现目前为止拥有最丰富的功能。不过，目前仍有很多其它的[[file:tools.org][工具]]能与 Org 进行交互。 #+begin_center #+attr_html: :class btn -[[file:tools.org][Tools that work with Org]] +[[file:tools.org][能与 Org 交互的工具]] #+end_center -* [[https://orgmode.org/worg/][Worg]], a /World/ of Org +* [[file:../worg/][Worg]]，Org /世界/ :PROPERTIES: :CUSTOM_ID: worg :END: -Org and Org-mode have so many use cases that it is simply not possible -to easily document them, let alone show them all off on a single page. -As a result, [[https://orgmode.org/worg/][Worg]] serves as a community wiki and provides a place to -document and share information about all aspects of using and working -with Org. +Org 的用法五花八门，因此我们无法把它们轻松地纪录下来，更别提把它们在一个网页里展示出来。因此，我们创造了[[file:../worg/][Worg]]作为社区百科，为纪录、分享用户们使用 Org 的各方面信息提供了空间。 -For example, Worg contains: +举个例子，[[file:../worg/][Worg]]包含了： -- [[https://orgmode.org/worg/org-faq.html][The FAQ]] -- [[https://orgmode.org/worg/org-hacks.html][Org hacks]] -- [[https://orgmode.org/worg/org-tutorials/index.html][A list of tutorials]] -- [[https://orgmode.org/worg/doc.html][Documentation on all hooks, commands and options]] -- [[https://orgmode.org/worg/org-in-the-wild.html][Org in the wild]] -- /...and much more/ +- [[file:../worg/org-faq.html][常见问题]] +- [[file:../worg/org-hacks.html][Org 妙招]] +- [[file:../worg/org-tutorials/index.html][各种教程]] +- [[file:../worg/doc.html][所有挂勾、命令与选项的文档]] +- [[file:../worg/org-in-the-wild.html][野生的 Org]] +- /……以及更多/ -Worg is maintained as a Git repository of Org files that are published -as an HTML website. New [[https://orgmode.org/worg/worg-about.html#contribute-to-worg][contributors are welcome]]. +[[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 #+END_SRC -* Joining the mailing list +* 加入邮件列表 :PROPERTIES: :CUSTOM_ID: mailing-list :END: -Org mailing list is the central place where to connect with Org -community. You can [[https://lists.gnu.org/mailman/listinfo/emacs-orgmode][subscribe to the list]] and browse the list archive -on [[https://list.orgmode.org][list.orgmode.org]] or on [[https://lists.gnu.org/archive/html/emacs-orgmode/][this mailman page]]. +Org 邮件列表是一个能与整个 Org 社区交流的地方。你可以[[https://lists.gnu.org/mailman/listinfo/emacs-orgmode][订阅此列表]]，也可以在[[https://list.orgmode.org][list.orgmode.org]]或者[[https://lists.gnu.org/archive/html/emacs-orgmode/][此 mailman 网页]]浏览往期邮件。​_请注意，此列表需要使用英语交流。_ + +即使你不是此列表的订阅者，你仍可以向[[mailto:emacs-orgmode@gnu.org][emacs-orgmode@gnu.org]]发送邮件，我们会把你加入白名单。 -If you are not a subscriber to the list, you can still send an email -to [[mailto:emacs-orgmode@gnu.org][emacs-orgmode@gnu.org]], we will add you to the whitelist of people -who can reach the list. +更多关于邮件列表的信息请见[[file:../worg/org-mailing-list.html][此网页（英语）]]。此外，Org 还有其它的[[file:../worg/org-web-social.html][社交平台（英语）]]。 -You can [[https://orgmode.org/worg/org-mailing-list.html][read more on the mailing list]] and more information on [[https://orgmode.org/worg/org-web-social.html][Org news -on the social web]]. +你也可以使用 IRC 在[[https://libera.chat/][Libera.Chat]]的 ~#org-mode~ 频道上与其它 Org 爱好者交流。​_请注意，此频道需要使用英语交流。_ -You can also connect with other org-thusiasts via IRC at ~#org-mode~ on -[[https://libera.chat/][Libera.Chat]]. +[[https://emacs-china.org][Emacs China]]是一个中文 Emacs 用户聚集的论坛。在此你可以讨论 Org 以及其他与 Emacs 相关的内容。​_请注意，此论坛需要使用中文交流。_ -The full [[https://orgmode.org/worg/contributors.html][list of contributors]] to Org mode is maintained in /Worg/ and -you can also check the manual's [[https://orgmode.org/org.html#History-and-Acknowledgments][acknowledgments]]. +Org 的完整贡献者列表在 /Worg/ 里[[file:../worg/contributors.html][可见（英语）]]。你也可以查看手册的[[file:../org.html#History-and-Acknowledgments][鸣谢（英语）]]。 -* Doom, Spacemacs, Scimax and popular configs +* Doom，Spacemacs，Scimax以及热门配置 :PROPERTIES: :CUSTOM_ID: configs :END: -The Emacs starter kits [[https://github.com/hlissner/doom-emacs][Doom]], [[https://www.spacemacs.org/][Spacemacs]] and [[https://github.com/jkitchin/scimax][Scimax]] come with a curated -set of packages and configurations that aim to enhance Org mode (and -Emacs more generally) for particular use cases. They include Org -along with integrations between =org-mode= and other modes (such as -=evil-mode=). Here are links to the current packages included with -[[https://github.com/hlissner/doom-emacs/blob/develop/modules/lang/org/packages.el][Doom]], and [[https://github.com/syl20bnr/spacemacs/blob/master/layers/%2Bemacs/org/packages.el][Spacemacs]]. /Scimax/ is deeply integrated with Org so a good -place to start is the [[https://github.com/jkitchin/scimax/blob/master/scimax.org#org-mode][manual]]. /Doom/ installs a version of Org that is -close to the development ~HEAD~, while /Spacemacs/ and /Scimax/ track org -elpa. - -Starter kits often make significant changes to the default user -experience for Emacs. If you are looking for something closer to -vanilla Emacs there are popular configs such as [[https://github.com/purcell/emacs.d/blob/master/lisp/init-org.el][Purcell's emacs.d]] that -include org-mode customization and Org-related packages. - -* In Other Editors +[[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]]。 + +* 其它文本编辑器 :PROPERTIES: :CUSTOM_ID: editors :END: -While the full set of Org [[file:features.html][features]] is currently exclusive to Emacs, -basic functionality for Org files has been implemented for a variety -of editors. Here are some extensions for other editors that enable -support for Org files. +尽管用户只能在 Emacs 上享受完整的 Org [[file:features.org][功能]]，但是 Org 文件的基本功能已经在一系列其它编辑器上被实现出来，详见以下列表： -- *Vim* : [[https://github.com/kristijanhusak/orgmode.nvim][orgmode.nvim]], [[https://github.com/jceb/vim-orgmode][vim-orgmode]], and [[https://github.com/axvr/org.vim][org.vim]] +- *Vim* : [[https://github.com/kristijanhusak/orgmode.nvim][orgmode.nvim]]、[[https://github.com/jceb/vim-orgmode][vim-orgmode]]、 [[https://github.com/axvr/org.vim][org.vim]] - *Atom* : [[https://atom.io/packages/org-mode][org-mode]] - *VS Codium* : [[https://github.com/vscode-org-mode/vscode-org-mode][vscode-org-mode]] -- 2.40.0