From b7772ec1822eb07111ae6c3a39677cd6a1c6f7c6 Mon Sep 17 00:00:00 2001 From: Ruijie Yu Date: Tue, 11 Apr 2023 01:32:26 +0800 Subject: [PATCH 11/16] * zh-CN/features.org: zh-CN translation --- zh-CN/features.org | 271 ++++++++++++++++----------------------------- 1 file changed, 97 insertions(+), 174 deletions(-) diff --git a/zh-CN/features.org b/zh-CN/features.org index 721ec29..0367040 100644 --- a/zh-CN/features.org +++ b/zh-CN/features.org @@ -1,7 +1,6 @@ -#+title: Features | Org mode +#+title: 功能 | Org #+setupfile: setup.org -#+description: Org: an Emacs Mode for Notes, Planning and Authoring -#+include: "./resources/preamble.html" export html +#+include: "resources/preamble.html" export html #+begin_export html - + #+end_export -* Elegant Markup +* 多种标记选项 :PROPERTIES: :CUSTOM_ID: markup :HTML_CONTAINER_CLASS: side-fig :END: -#+attr_html: :class main-image :style max-height:12em; :alt Example basic Org document showing the key textual elements +#+attr_html: :class main-image :style max-height:12em; :alt 使用文字元素标记文本的例子 [[file:resources/img/features/simple-syntax.svg]] - -** Description -Org mode is routinely used to build and manage complex workflows. It -does this using an elegantly simple syntax that scales from basic -markup to full LaTeX typesetting and from plain text notes to literate -programs. +** 描述 -Everything you need to get started is demonstrated in the example. +Org 常被用于构建与管理复杂的工作流程。为此，Org 使用了优美且简单的语法，从最基本的标记到完整的 LaTeX 排版，从纯文本到文学程序，都可以使用 Org 编写而成。 -*** More +以下这个例子包含了所有你开始使用 Org 需要的内容。 -More on [[file:manual/Markup-for-Rich-Contents.html][markup]] (manual) +*** 更多 -* Structured Editing@@comment: and Navigation@@ +详见手册（英语）：[[file:../manual/Markup-for-Rich-Contents.html][标记]] + +* 结构化的编辑@@comment:与导航@@ :PROPERTIES: :CUSTOM_ID: editing :HTML_CONTAINER_CLASS: side-fig :END: -#+attr_html: :class main-image :alt Demonstration of folding and unfolding sections in Org +#+attr_html: :class main-image :alt 演示在 Org 里折叠与显示章节 [[file:resources/img/features/folding.gif]] -** Description +** 描述 -The fundamental structure of an Org document is a tree, with nested, -collapsible sections forming its backbone. You can fold and unfold -whole trees with single keystroke --- =tab=. +Org 里最基础的结构是由可嵌套、可折叠的章节构成的树。你可以使用一个快捷键 ----- =tab= ----- 来折叠、展开整个树。 -Org's trees make for quick, graceful navigation and powerful -information hiding that lets you focus on the task at hand without -compromising the ability to get the information you need complete it. +Org 的树结构给用户带来了快速且优雅的导引与强大的信息遮避功能，让你在保持获取需要信息的能力的同时专心于手头的任务。 -Controlling section visibility is only a tiny part of Org's set of -tools and commands for structured editing of plain text. Org mode -leverages Org's regular syntax to transform otherwise tedious tasks -into single key commands, freeing you to focus on content rather than -form. +控制章节可见与否只是 Org 的一个小小的功能，而 Org 仍有其它多种工具与命令来为结构化地编辑纯文本带来便利。 Org 的语法让用户把枯燥的任务变成了单个的键盘命令，让用户更着重于内容而不是形式。 -*** More +*** 更多 -More on [[file:manual/Document-Structure.html][document structure]] (manual) +详见手册（英语）：[[file:../manual/Document-Structure.html][文档结构]] -* Transparent Tables +* 透明化的表格处理 :PROPERTIES: :CUSTOM_ID: tables :HTML_CONTAINER_CLASS: side-fig :END: -#+attr_html: :class main-image :alt Manipulating tables with Org, moving cells/rows and executing formulas +#+attr_html: :class main-image :alt 在 Org 中处理表格，移动行列以及运行公式 [[file:resources/img/features/tables.gif]] -** Description - -Org includes a powerful table editor. +** 描述 -=tab= moves between /columns/. -=return= moves between /rows/. +Org 自带了一个强大的表格编辑器。 -Layout updates automatically as cell contents change. +按 =tab= 可以左右移动；按 =return= 可以上下移动。 -Import tables from =.csv= and =.tsv= files, or directly from the -contents of the current buffer, then export them to any format -supported by Org. +在内容发生改变时，表格结构会自动更新。 -Org tables aren't just static views of data. They can be used as a -full [[https://orgmode.org/manual/The-Spreadsheet.html][spreadsheet]] system, with formulas, references and more --- all -with the simplicity and transparency of plain text. +可以从 =.csv= 和 =.tsv= 文件，或直接从当前缓存区中导入表格，也可以把表格导出到任何 Org 支持的格式。 -*** More +Org 表格不只是静态的数据堆积。它也可以被视作一个完整的[[file:../manual/The-Spreadsheet.html][表格]]系统，包含公式、引用等等 ----- 同时不失其作为纯文本系统的简洁与透明。 -The [[file:manual/Built_002din-Table-Editor.html][built-in table editor]] (manual) +*** 更多 -Org as a [[file:manual/The-Spreadsheet.html][spreadsheet]] system (manual) +详见手册（英语）：[[file:../manual/Built_002din-Table-Editor.html][表格编辑器]]、[[file:../manual/The-Spreadsheet.html][表格系统]] -Introduction to [[https://orgmode.org/worg/org-tutorials/tables.html][editing tables]] (Worg) +Worg 教程（英语）：[[file:../worg/org-tutorials/tables.html][使用表格工作]]、[[file:../worg/org-tutorials/org-spreadsheet-intro.html][表格系统]] -Using [[https://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.html][Org as a spreadsheet]] (Worg) - -* Superior Source Code +* 更优越的源代码 :PROPERTIES: :CUSTOM_ID: babel :HTML_CONTAINER_CLASS: side-fig @@ -125,223 +104,167 @@ Using [[https://orgmode.org/worg/org-tutorials/org-spreadsheet-intro.html][Org a #+attr_html: :class main-image :alt Demonstration of Org Babel executing code blocks [[file:resources/img/features/babel.gif]] -** Description +** 描述 -Org provides functionality far beyond that of computational notebooks -such as [[https://jupyter.org/][Jupyter]] or [[https://rmarkdown.rstudio.com/][R Markdown]]. +Org 提供的功能远远超过[[https://jupyter.org/][Jupyter]]、[[https://rmarkdown.rstudio.com/][R Markdown]]等计算笔记本。 # Program your way. -[[https://orgmode.org/worg/org-contrib/babel/][Org babel]] transforms the lowly executable source block into a complete -[[https://en.wikipedia.org/wiki/Literate_programming][literate programming]] environment, allowing you to weave the inputs and -outputs of multiple languages and runtime environments across multiple -machines into a single unified system, empowering you to achieve new -levels of [[https://en.wikipedia.org/wiki/Don%27t_repeat_yourself][DRYness]] regardless of whether the languages you are working -in want you to or not. +[[file:../worg/org-contrib/babel/][Org babel]]把可运行的代码区转换为一个完整的[[https://en.wikipedia.org/wiki/Literate_programming][文学编程（英语，外网）]]环境，使得用户可以用输入与输出串联不同的语言、运行环境、甚至不同的设备到同一个系统里。用户就此可以在[[https://en.wikipedia.org/wiki/Don%27t_repeat_yourself][DRY（英语，外网）]]上达到一个前所为有的高度。 # Free your code -Org makes it trivial to extract source code and generate documentation -from the same file. While many languages have support for generating -developer documentation from code comments, with Org your developer -guide and user manual can also be the source code for implementation -and testing --- a single source of truth that won't drift out of sync. +使用 Org ，你可以非常简单地从同一个文件里提取源代码与生成帮助文档。尽管很多语言支持从代码备注里生成文档，Org 还可以同时在同一个文件里放入开发者指南、用户手册、实现以及测试 ----- 因此，每个 Org 文件是唯一的、不会逐步失去同步的信息源。 # Emacs. We will add your technological distinctiveness to our own. -Org currently has support for over [[https://orgmode.org/worg/org-contrib/babel/languages/index.html][80 languages]], and projects like -[[https://github.com/nnicandro/emacs-jupyter#org-mode-source-blocks][emacs-jupyter]] make it possible to leverage the Jupyter kernel -ecosystem for even more languages. +Org 目前支持超过[[file:../worg/org-contrib/babel/languages/index.html][80种不同语言]]，并且像[[https://github.com/nnicandro/emacs-jupyter#org-mode-source-blocks][emacs-jupyter]]这样的组件使得用户可以利用 Jupyter 内核生态来使用更多的语言。 + +*** 更多 -*** More +详见手册（英语）：[[file:../manual/Working-with-Source-Code.html][使用源代码]] -[[file:manual/Working-with-Source-Code.html][Working with source code]] (manual) +Worg（英语）：[[file:../worg/org-contrib/babel/languages/index.html][支持语言]]列表 -List of [[https://orgmode.org/worg/org-contrib/babel/languages/index.html][supported languages]] (Worg) -* Export and Publish +* 导出与发布 :PROPERTIES: :CUSTOM_ID: publishing :HTML_CONTAINER_CLASS: side-fig :END: # Powerful publishing -#+attr_html: :class main-image :alt Showing an Org file being exported to HTML, markdown, PDF and plaintext +#+attr_html: :class main-image :alt 示范如何把一个 Org 文件导出到 HTML，markdown，PDF 以及纯文本 [[file:resources/img/features/exports.gif]] -** Description +** 描述 -Org is an authoring and publishing tool --- it can function as -everything from a static site generator, to a suite of tools for -self-publishing. +Org 是一个撰写与发布的工具 ----- 它既可以是静态网页生成器，也可以是一系列为发布内容提供便利的工具。 -Draft documents using Org's intuitive markup, then export to your -format of choice. Org supports many formats including: +你使用 Org 的简洁易懂的标记语法来撰写稿件，然后导出到你所选择的任何一种格式。 Org 支持很多格式，其中包含： - =HTML= -- $\LaTeX$ +- \(\LaTeX\) - =ODT= -- and more! +- 以及更多！ -Developers can easily create new backends for their favorite format -(see the [[https://orgmode.org/worg/dev/org-export-reference.html][ox reference documentation]]) and Org is also supported by -[[https://pandoc.org][Pandoc]]. +开发者可以轻松地为任何格式创造新的导出后端（详见[[file:../worg/dev/org-export-reference.html][ox的文档]]),并且 Org 也被[[https://pandoc.org][Pandoc]]支持。 -In addition to exporting single files, you can define /publishing -projects/ for one or more =.org= files and accompanying resources, -targeting one or more publication backends. +除开导出单一的文件以外，你还可以​/发布项目/ ----- 将一个或更多的 =.org= 文件以及其需要的各种资源导出到一个或更多的发布后端。 -*** More +*** 更多 -One poorly kept secret is that the Org website is written in Org! +冷知识：Org 的网页是由 Org 编写而成！ -More on [[file:manual/Markup-for-Rich-Contents.html][markup]] (manual) +详见手册（英语）：[[file:../manual/Markup-for-Rich-Contents.html][标记]]，[[file:../manual/Exporting.html][导出]]，[[file:../manual/Publishing.html][发布]] -More on [[file:manual/Exporting.html][exporting]] (manual) +Worg 教程（英语）：发布到 [[file:../worg/org-tutorials/org-publish-html-tutorial.html][HTML]] ；发布到 [[file:../worg/org-tutorials/org-latex-export.html][\(\LaTeX\)]] -More on [[file:manual/Publishing.html][publishing]] (manual) - -[[https://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.html][Tutorial on publishing]] to HTML (Worg) - -[[https://orgmode.org/worg/org-tutorials/org-latex-export.html][Tutorial on publishing]] to $\LaTeX$ (Worg) -* Take Control of Tasks +* 把握任务的进程 :PROPERTIES: :CUSTOM_ID: planning :HTML_CONTAINER_CLASS: side-fig :END: -#+attr_html: :class main-image :alt Demonstration of planning with org, managing a scheduled todo list +#+attr_html: :class main-image :alt 演示在 Org 里设置计划，管理一个待办事项 [[file:resources/img/features/planning.gif]] -** Description - -Org is an extremely capable task planner, time tracker and TODO list. +** 描述 -Any section can become a /TODO item/ by adding a keyword such as =TODO= or -=HOLD= to track the state of the task. You can cycle through task -states with the shortcuts =S-= and =S-=. +Org 是一个功能齐全的任务计划工具、时间管理工具以及待办事项工具。 -Need add your own set of states? No problem. Org lets you customize -them to support your workflow. +任何一个章节都可以通过增加例如 =TODO= 或者 =HOLD= 等关键词来被设置成​/待办事项/​。你可以由此跟踪纪录此任务的进度。你也可以使用快捷键 =S-= 和 =S-= 来把任务切换到不同状态。 -Org /Agenda/ makes it easy to view tasks from multiple files in one -place. All you have to do is add one of the TODO keywords. Org has -built-in support for task priority, deadlines, scheduled tasks, tags, -clocking and more. /Agenda/ can use of all of it to organize and -prioritize tasks --- seamlessly scaling from a simple TODO list into a -complete project management suite, all with plain text markup. +需要增加其他的任务状态？没问题。你可以根据你的工作流程自由地设置任务状态。 -*** More +在 Org /日程/​（Agenda）里，你可以轻松地查看多个文件里的任务 ----- 你仅需要添加一个任务状态关键词，例如 =TODO=​。Org 为以下功能有内置支持：任务优先级、截止日期、计划中任务、标签、打卡等等。​/日程/​能够使用上述所有功能来整理任务以及设置优先级。因此，在仅需使用纯文本标记的同时，你可以把一个简单的待办事项列表无缝升级为一个完整的项目管理软件。 -More on [[file:manual/TODO-Items.html][TODO items]] (manual) +*** 更多 -Handling [[file:manual/Dates-and-Times.html][dates and times]] (manual) +详见手册（英语）：[[file:../manual/TODO-Items.html][待办事项]]、处理[[file:../manual/Dates-and-Times.html][日期与时间]] -* Actionable Agendas +* 可执行的日程表 :PROPERTIES: :CUSTOM_ID: agendas :HTML_CONTAINER_CLASS: side-fig :END: -#+attr_html: :class main-image :alt An example Org agenda, displaying various todo keywords, priorities, categorisation and scheduling +#+attr_html: :class main-image :alt Org 日程的一个例子，显示了不同的待办关键词、优先级、分类方式以及计划 [[file:resources/img/features/agenda.svg]] -** Description +** 描述 -Plan your day, your way, with ease. +轻松计划你的一天，方式由你而定。 -With /agenda views/ --- reports generated from your /TODO items/ --- you -can see your tasks on a daily, weekly and monthly basis. +在​/日程界面/​里（一个由你所有待办事项组成的报告），你可以看到你每日、每周、每月的任务。 -Even with hundreds of =.org= files and thousands of tasks, agenda lets -you focus on what you need to do and quickly take action, jumping -from the high level overview directly into the task at hand. +就算你有上百个 =.org= 文件以及上千个任务，日程仍可以让你集中精力攻克你最需要响应的任务 ----- 并且你可以从日程的优先级界面可以直接跳到你手头这个需要完成的任务。 -The default agenda shows scheduled and deadlined tasks for the week, -stalled projects and all your outstanding TODO items. +日程的默认界面显示了你当周里计划中的、临近截止的、暂停的、以及未完成的待办任务。 -Not satisfied with the defaults? Org agenda is highly configurable. -You can customize the contents of default views or create your own -[[https://orgmode.org/manual/Custom-Agenda-Views.html][custom views]]. +对这个默认界面不满意？你可以随意修改 Org 日程的配置。你既可以修改其默认界面，也可以创建[[file:../manual/Custom-Agenda-Views.html][自定义界面]]。 -In a sense Org is an expressive language that captures the key points -of interaction in workflows, simplifying and refining the process of -developing new workflows as they emerge during the course of work, -play, or life in general. +从某种程度上来说，Org 是一个富有表达力的、能抓取在工作进程里的交互关键点的语言，使你在因生活、工作、娱乐等等需要构建新的工作进程时的步骤变得更加简单易懂。 -*** More +*** 更多 -More on [[file:manual/Agenda-Views.html][agenda views]] (manual) +详见手册（英语）：[[file:../manual/Agenda-Views.html][日程界面]] -Tutorial on [[https://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.html][agenda commands]] (Worg) +Worg 教程（英语）：[[file:../worg/org-tutorials/org-custom-agenda-commands.html][日程命令]] -* Clocking +* 打卡 :PROPERTIES: :CUSTOM_ID: clocking :HTML_CONTAINER_CLASS: side-fig :END: -#+attr_html: :class main-image :alt Using Org to keep track of how long various subtasks took +#+attr_html: :class main-image :alt 使用 Org 来纪录每个小任务花费的时间 [[file:resources/img/features/clocking.svg]] -** Description +** 描述 -Keep track of the time you spend on your tasks with Org /Clocking/, and -at end of the day you can generate customized reports about how you -spent your time. +使用 Org /打卡/​（clocking）来纪录你花费在任务上的时间。你可以在一天结束之际生成关于你当天如何使用时间的报告。 -Org provides shortcuts to /clock in/ and /clock out/ of tasks. When -working in an =.org= file =C-c C-x C-i= clocks in and =C-c C-x C-o= clocks -out. Time is stored in the property drawer of the heading for the -task at had. +Org 提供了给开始任务与结束任务打卡的快捷键。当你在使用一个 =.org= 文件时，按下 =C-c C-x C-i= 来打卡开始任务，​=C-c C-x C-o= 来打卡结束任务。所有的打卡时间都被存储在该任务标题的属性抽屉里。 -You can also use =I= and =O= when in an agenda view. +当你在日程界面时，你可以使用 =I= 和 =O= 打卡。 -*** More +*** 更多 -More on [[file:manual/Clocking-Work-Time.html][clocking tasks]] (manual) +详见手册（英语）：[[file:../manual/Clocking-Work-Time.html][任务打卡]] -* Capture Data From Anywhere +* 从任何地方抓取信息 :PROPERTIES: :CUSTOM_ID: capturing :HTML_CONTAINER_CLASS: side-fig :END: -#+attr_html: :class main-image :alt Using Org Capture to record an idea while editing a file +#+attr_html: :class main-image :alt 使用 Org Capture 来纪录编辑文件时产生的一个想法 [[file:resources/img/features/capturing.gif]] -** Description +** 描述 -You can add content to an =.org= file by /capturing/ data. +你可以​/抓取/​信息，然后把它加入到一个 =.org= 文件里。 -You can capture from anywhere --- from an Emacs buffer or from other -applications like your web browser, PDF viewer and more. +你可以从任何地方抓取信息 ----- 可以是一个 Emacs 缓存区，也可以是其它程序，例如你的浏览器、PDF 阅览器等等。 -Capture templates provide a quick and effective way to ingest -structured data for a variety of workflows, from adding TODO items to -quoting the relevant section of a manual or saving a receipt. +抓取模版让你快速且便捷地从各种工作流程中抓取信息，例如增加新任务、引用手册的关联章节、或者保存收据。 -*** More +*** 更多 -More on [[file:manual/Capture.html][capturing]] (manual) +详见手册（英语）：[[file:../manual/Capture.html][抓取]] -* Extremely Extensible +* 极度的可扩展性 :PROPERTIES: :CUSTOM_ID: extensibiliy :HTML_CONTAINER_CLASS: side-fig :END: -#+attr_html: :class main-image :alt Display of some default and custom Org link types +#+attr_html: :class main-image :alt 显示一些自带的以及自定义的链接种类 [[file:resources/img/features/links.svg]] -** Description +** 描述 -Org mode isn't just extensible, it is /Emacs extensible/. +Org 不只是一般的“可扩展”；它是 /Emacs 级别/​的可扩展。 -Org started out as an extension. As a result, extensibility is present -in nearly every aspect of Org. +Org 起初只是 Emacs 的一个扩展组件。因此，Org 的各方各面都包含了对可扩展性的考量。 -To give only a single example, consider hyperlinks. While updating -documentation you find yourself repeatedly linking to GitHub -issues. In Org you can add a new ~issue:~ link type to the document so -that ~[[issue:74][big bug]]~ expands to -=https://github.com/author/repo/issues/74=. +举一个小小的例子：超链接。当你在更新开发文档时你会经常重复引用到项目的问题列表，例如GitHub Issues。你可以在 Org 文件里添加一个新的 ~issue:~ 链接类型，使得类似​~[[issue:74][big bug]]~​的链接能够引用到​=https://github.com/author/repo/issues/74=​。 -Beyond expanding links, you can define custom resolving functions, -link to files on remote machines with [[https://www.emacswiki.org/emacs/TrampMode][Tramp]], and more. +除了超链接，你也可以自定义解析函数、使用 [[https://www.emacswiki.org/emacs/TrampMode][Tramp]] 链接远程设备的文件，等等。 -- 2.40.0