emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: lux <lx@shellcodes.org>
To: emacs-orgmode@gnu.org
Subject: Add a Chinese version to index.org of orgmode.org
Date: Tue, 08 Aug 2023 14:21:22 +0800	[thread overview]
Message-ID: <tencent_D08DCAF386AB0403710ACEFCD4D4D474DF0A@qq.com> (raw)

[-- Attachment #1: Type: text/plain, Size: 148 bytes --]

Hi
  To facilitate Chinese users' understanding of Org Mode, I have
translated index.org into Simplified Chinese. Please review it.


Thanks.

[-- Attachment #2: 0001-Added-index.org-for-Chinese-page.patch --]
[-- Type: text/x-patch, Size: 17335 bytes --]

From 0f7725bca75aa16e7398709137108d6d4a05bfb2 Mon Sep 17 00:00:00 2001
From: Xi Lu <lx@shellcodes.org>
Date: Tue, 8 Aug 2023 13:39:22 +0800
Subject: [PATCH] Added index.org for Chinese page

---
 cn/index.org            | 176 ++++++++++++++++++++++++++++++++++++++++
 cn/org-demo.html        | 131 ++++++++++++++++++++++++++++++
 resources/preamble.html |   3 +-
 3 files changed, 309 insertions(+), 1 deletion(-)
 create mode 100644 cn/index.org
 create mode 100644 cn/org-demo.html

diff --git a/cn/index.org b/cn/index.org
new file mode 100644
index 0000000..6295ada
--- /dev/null
+++ b/cn/index.org
@@ -0,0 +1,176 @@
+#+title: Org mode for Emacs
+#+setupfile: ../setup.org
+#+language:  cn
+#+description: Org: an Emacs Mode for Notes, Planning and Authoring
+#+html_head: <link rel="stylesheet" href="/resources/style/index.min.css" type="text/css" />
+#+html_head: <link rel="preload" href="/resources/img/org-mode-unicorn.svg" as="image" type="image/svg+xml">
+#+include: "../resources/preamble.html" export html
+
+#+html_head: <link rel="stylesheet" href="/resources/style/org-demo.min.css" type="text/css" />
+#+include: "../resources/normal-outline-3.html" export html
+
+#+begin_export html
+<div class="banner hero" itemscope itemtype="https://schema.org/SoftwareApplication">
+  <img src="/resources/img/org-mode-unicorn.svg"
+       alt="Org unicorn logo" itemprop="image"/>
+  <div>
+    <h2>
+      <span itemprop="name">Org Mode</span>
+      <p class="subtitle">用纯文本来记录生活</p>
+    </h2>
+    <p>
+      Org Mode 是 <a href="https://www.gnu.org/software/emacs/" style="color: inherit; font-weight: bold; font-style: italic;"
+           title="An extensible, customizable, free/libre text editor">GNU Emacs</a>
+      的一种主模式,适用于<span itemprop="applicationCategory">记笔记、撰写文档、计算笔记本、文学编程、管理待办事项列表、项目规划等等。一切都可以在这个快速高效的纯文本系统中实现。</p>
+      <p><a title="Install from GNU ELPA" href="https://elpa.gnu.org/packages/org.html"><img src="https://elpa.gnu.org/packages/org.svg" alt="Install from GNU ELPA" /></a>
+        <a title="How to report a bug" href="https://orgmode.org/manual/Feedback.html"><img src="/resources/img/badge-report-bug.svg" alt="How to report a bug" /></a>
+        <a title="Email the Org-mode mailing list" href="mailto:emacs-orgmode@gnu.org"><img src="/resources/img/badge-feedback.svg" alt="Email the Org-mode mailing list" /></a>
+        <a title="Git clone repository URL" href="https://git.savannah.gnu.org/cgit/emacs/org-mode.git"><img src="/resources/img/badge-source-code.svg" alt="Git clone repository URL" /></a>
+        <a title="sr.ht project page" href="https://sr.ht/~bzg/org"><img src="/resources/img/badge-srht-project.svg" alt="sr.ht project page"/></a></p>
+    <p class="bubble">
+      捐助:
+      <a href="https://liberapay.com/org-mode" title="Donations always help"
+         style="font-weight: bold; display: inline-block">
+        <img class="inline" src="/resources/img/external/librepay.svg" alt="Liberapay logo"/>
+        Liberapay</a></p>
+    <meta itemprop="operatingSystem" content="Linux, MacOS, Windows">
+    <meta itemprop="softwareVersion" content="9.3.8">
+    <meta itemprop="datePublished" content="2020-08-07">
+    <meta itemprop="url" content="https://orgmode.org">
+  </div>
+</div>
+<div class="banner slim grey faded inline">
+  <p style="width:90vw; color:#515151">
+    由
+    <a target="new" href="https://staff.science.uva.nl/~dominik/"
+       style="font-weight:500; color:inherit">Carsten Dominik</a>
+    创建于 <a target="new" href="/manual/History-and-Acknowledgments.html" style="color:#6e6e6e">2003 年</a>,
+    由 <a target="new" href="https://bzg.fr/en/" style="font-weight:500; color:inherit">Bastien Guerry</a> 主要维护,以及
+    <a href="https://orgmode.org/org.html#History-and-Acknowledgments" style="color:#6e6e6e">众多开发者 </a>一同参与。</p>
+</div>
+#+end_export
+
+* Highlights
+  :PROPERTIES:
+  :HTML_CONTAINER_CLASS: columns no-heading
+  :END:
+
+** 特色
+   @@html:<a href="/features.html">@@
+   #+attr_html: :alt Three stars :title Delve into the possibilities
+   [[file:../resources/img/stars.svg]]
+
+   @@html:</a>@@
+
+** 安装
+   @@html:<a href="https://orgmode.org/org.html#Installation">@@
+   #+attr_html: :alt Downwards facing arrow :title What are you waiting for?
+   [[file:../resources/img/install.svg]]
+
+   @@html:</a>@@
+
+** 快速入门
+   @@html:<a href="/quickstart.html">@@
+   #+attr_html: :alt Running stickfigure :title Start using Org. You'll never stop.
+   [[file:../resources/img/quickstart.svg]]
+
+   @@html:</a>@@
+
+** 贡献
+   @@html:<a href="/worg/org-contribute.html">@@
+   #+attr_html: :alt Git branch symbol :title Yes. Do this.
+   [[file:../resources/img/contribute.svg]]
+
+   @@html:</a>@@
+
+* Elaboration + demo image                                        :ignore:
+
+  #+attr_html: :style margin-top:2rem;
+  Org 是一个高度灵活的结构化的纯文本格式,由一些简单又灵活的结构组成。即能[[https://karl-voit.at/2017/09/23/orgmode-as-markup-only/][简单易学]],也能变得[[http://howardism.org/Technical/Emacs/literate-devops.html][专业、强大]]。
+
+  通过下面的示例,您能一窥 Org 的表现力。点击标题和链接可以了解 Org 是如何智能地折叠结构化的内容。
+
+  #+include: ./org-demo.html export html
+
+* 相关文档
+  :PROPERTIES:
+  :CUSTOM_ID: reading
+  :END:
+
+除了[[file:../quickstart.org][快速入门]]和[[file:../manual/index.html][手册]]外,Org 还提供了另一份[[file:../guide/index.html][指南]],以及在 [[https://orgmode.org/worg/][Worg]] 上丰富的社区文档。
+
+几乎每位 Org 用户都有一个故事来讲述 Org 是如何帮助与赋能他们的——有些人发现 Org 非常有用,于是撰写了[[https://orgmode.org/worg/org-papers.html][(科学)论文]],介绍 Org 在开展[[https://en.wikipedia.org/wiki/Reproducibility#Reproducible_research][可重复性研究]]方面的价值;有些人则制作了第三方工具,以便在 Emacs 之外使用 Org,例如移动应用程序。
+
+* 更多
+  :PROPERTIES:
+  :CUSTOM_ID: more
+  :END:
+
+/事实上/ ,Org 文件的 mimetype 是 =text/org= ;Org 文件用 .org 做扩展名。虽然多数操作系统默认都不是用 Emacs 中打开 .org 文件,但也能轻松地改变配置。
+
+虽然 Emacs Lisp 里的 Org 实现是迄今为止功能最丰富的,但还有许多其他[[file:../tools.org][工具]]可以与 Org 配合使用。
+
+#+begin_center
+#+attr_html: :class btn
+[[file:../tools.org][适用于 Org 的工具]]
+#+end_center
+
+* [[https://orgmode.org/worg/][Worg]], Org 的广阔世界
+  :PROPERTIES:
+  :CUSTOM_ID: worg
+  :END:
+
+Org 与 Org-mode 使用案例多得无法轻松地将它们记录下来,更不用说要在一个页面上就能展示出它们了。
+因此,[[https://orgmode.org/worg/][Worg]] 作为一个社区 Wiki,是一个用于记录及分享有关使用 Org 的各方面信息的地方。
+
+例如,Worg 包括了:
+
+- [[https://orgmode.org/worg/org-faq.html][FAQ 文档]]
+- [[https://orgmode.org/worg/org-hacks.html][Org hacks]]
+- [[https://orgmode.org/worg/org-tutorials/index.html][各种教程列表]]
+- [[https://orgmode.org/worg/doc.html][所有的 hook、命令和选项文档]]
+- [[https://orgmode.org/worg/org-in-the-wild.html][第三方资源]]
+- /...及其他/
+
+Worg 用 Git 仓库管理 Org 文件,并以 HTML 形式发布,[[https://orgmode.org/worg/worg-about.html#contribute-to-worg][欢迎新的贡献]]。
+
+#+BEGIN_SRC shell
+~$ git clone https://git.sr.ht/~bzg/worg
+#+END_SRC
+
+* 加入邮件列表
+  :PROPERTIES:
+  :CUSTOM_ID: mailing-list
+  :END:
+
+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]],我们会将您添加到可以访问列表的白名单中。
+
+您可以在[[https://orgmode.org/worg/org-mailing-list.html][邮件列表中阅读更多的内容]],以及在[[https://orgmode.org/worg/org-web-social.html][社交网络的 Org 新闻]]上获取更多信息。
+
+您还可以通过 [[https://libera.chat/][Libera.Chat]] 上的 ~#org-mode~ IRC 与其他爱好者取得联系。
+
+Worg 中保留了 Org mode 贡献者的[[https://orgmode.org/worg/contributors.html][完整名单]],您也可以查看手册的[[https://orgmode.org/org.html#History-and-Acknowledgments][致谢]]内容。
+
+* Doom、Spacemacs、Scimax 和主流配置
+  :PROPERTIES:
+  :CUSTOM_ID: configs
+  :END:
+
+Emacs 的入门套件 [[https://github.com/hlissner/doom-emacs][Doom]]、[[https://www.spacemacs.org/][Spacemacs]] 和 [[https://github.com/jkitchin/scimax][Scimax]] 都附带一组精选的软件包和配置,
+皆为在特定用例下增强 Org mode(以及更广泛的 Emacs)。它们包括 Org 与 =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 深度集成,因此可以从[[https://github.com/jkitchin/scimax/blob/master/scimax.org#org-mode][手册]]开始学习; /Doom/ 安装的是接近开发 ~HEAD~ 版本的 Org;而 /Spacemacs/ 和 /Scimax/ 则跟踪 org elpa。
+
+入门套件通常会对 Emacs 的默认用户体验进行重大修改。如果你正在寻找更接近原版 Emacs 的配置,可以使用 [[https://github.com/purcell/emacs.d/blob/master/lisp/init-org.el][Purcell 的 emacs.d]] ,其中包括 org-mode 自定义和与 Org 相关的软件包。
+
+* 在其他编辑中使用 Org
+  :PROPERTIES:
+  :CUSTOM_ID: editors
+  :END:
+
+虽然全套[[file:../features.html][特性]]的 Org 目前只有 Emacs 才有,但各种编辑器都实现了 Org 的基本功能。下面是一些支持 Org 文件的其他编辑器扩展:
+
+- *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]]
diff --git a/cn/org-demo.html b/cn/org-demo.html
new file mode 100644
index 0000000..f30aceb
--- /dev/null
+++ b/cn/org-demo.html
@@ -0,0 +1,131 @@
+<div id="org-demo" style="counter-set: chk 0">
+  <asside class="label-left">元数据 </asside>
+  <pre class="label-left">
+#+title:  <span class="org-document-title">Org 示例文件</span>
+#+author: <span class="org-document-info">TEC</span>
+#+date:   <span class="org-document-info">2020-10-27</span></pre>
+  <details open>
+    <summary>
+      <asside class="right" style="position: relative; z-index: -1">
+	<h4>大纲</h4>
+        标题与折叠功能使得结构化编辑变得更加轻松。
+        使用纯文本的 Org 文件也易于文件同步及版本控制。
+      </asside>
+      <pre><span class="org-level-1">* 改版 orgmode.org 网站</span></pre>
+    </summary>
+    <asside class="left">
+      <h4>日程表</h4>
+      列出待办事项。
+      筛选内容,及实时更新。
+    </asside>
+    <pre>
+
+<b>*必须*</b> 分享 org <i>/之美/</i>。</pre>
+    <details class="replace">
+      <summary>
+	<pre><span class="org-link">[[https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg]]</span></pre>
+      </summary>
+      <img src="https://upload.wikimedia.org/wikipedia/commons/b/bd/Share_Icon.svg" alt="share icon" style="height: 3em; margin-left: 1.5em"/>
+    </details>
+    <details open class="br">
+      <summary>
+	<pre><span class="org-level-2">** <span class="org-done">DONE 截图</span></span></pre>
+      </summary>
+      <pre>   <span class="org-special-keyword">CLOSED:</span> <span class="org-date">[2020-09-03 Thu 18:24]</span>
+
+</pre>
+    </details>
+    <details open>
+      <summary>
+	<pre><span class="org-level-2">** <span class="org-done">DONE 重新设计网站的 CSS</span></span></pre>
+      </summary>
+      <pre>
+
+查看:<span class="org-link"><a href="/resources/style/org.css">[[file:style.scss][stylesheet]]</a></span>
+
+</pre>
+    </details>
+    <input type="checkbox" class="chk" id="chk1" checked />
+    <input type="checkbox" class="chk" id="chk2" checked />
+    <input type="checkbox" class="chk extra" id="chk3" />
+    <input type="checkbox" class="chk" id="chk4" />
+    <input type="checkbox" class="chk" id="chk5" checked />
+    <input type="checkbox" class="chk extra" id="chk6" />
+    <input type="checkbox" class="chk" id="chk7" />
+    <details>
+      <summary>
+	<pre><span class="org-level-2">** <span class="org-todo">TODO</span> 检查主要页面的 CSS <span class="count-res"></span></span></pre>
+      </summary>
+      <pre class="countme">
+
+<label for="chk1"><span class="org-list-dt">-</span> Index page</label>
+<label for="chk2"><span class="org-list-dt">-</span> Quickstart</label>
+<label for="chk3"><span class="org-list-dt">-</span> Features</label>
+<label for="chk4"><span class="org-list-dt">-</span> Releases</label>
+<label for="chk5"><span class="org-list-dt">-</span> Install</label>
+<label for="chk6"><span class="org-list-dt">-</span> Manual</label>
+<label for="chk7"><span class="org-list-dt">-</span> Contribute</label>
+</pre>
+    </details>
+  </details>
+  <details open class="label-left">
+    <summary>
+      <asside class="label-left">文本段落</asside>
+      <pre><span class="org-level-1">* 学习 Org</span></pre>
+    </summary>
+    <pre>
+
+Org 让事情变得如履平地。
+
+你只需要阅读快速入门页面,就可以开始上手 Org 了。
+如果还未能满足,请深入 Org 的手册,以及参与到社区里!
+    </pre>
+    <details open>
+      <summary>
+	<pre><span class="org-level-2">** 反馈</span></pre>
+      </summary>
+      <pre>
+
+<span class="org-special-keyword">#+include: "other/feedback.org*manual" :only-contents t</span></pre>
+    </details>
+  </details>
+  <details open>
+    <summary>
+      <pre>
+<span class="org-level-1">* 检查 CSS 压缩比</span>
+      </pre>
+    </summary>
+    <asside class="right">
+      <h4>Babel</h4>
+
+      在 Org 中进行文学编程,实时获得代码执行的结果。
+    </asside>
+    <asside class="label-left">代码块</asside>
+    <details open>
+      <summary><pre class="label-left" style="background-color: #ccc4"><span class="org-block-begin-line">#+begin_src python</span></pre></summary>
+      <pre class="src label-left" style="background-color: #fff4">
+<span class="org-keyword">from</span> pathlib <span class="org-keyword">import</span> Path
+<span class="org-variable-name">cssRatios</span> = []
+<span class="org-keyword">for</span> css_min <span class="org-keyword">in</span> Path(<span class="org-string">"resources/style"</span>).glob(<span class="org-string">"*.min.css"</span>):
+    <span class="org-variable-name">css</span> = css_min.with_suffix(<span class="org-string">''</span>).with_suffix(<span class="org-string">'.css'</span>)
+    cssRatios.append([css.name,
+    <span class="org-string">"{:.0f}% minified ({:4.1f} KiB)"</span>.<span class="org-builtin">format</span>( <b>100</b> *
+                      css_min.stat().st_size / css.stat().st_size,
+                      css_min.stat().st_size / <b>1000</b>)])
+<span class="org-keyword">return</span> cssRatios
+</pre>
+      <pre class="label-left" style="background-color: #ccc4"><span class="org-block-end-line">#+end_src</span></pre>
+    </details>
+    <details open>
+      <summary>
+	<asside class="label-left">代码执行结果</asside>
+	<pre class="label-left br"><span class="org-block-begin-line">#+RESULTS:</span></pre>
+      </summary>
+      <pre class="label-left"><span class="org-table">| 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) |
+</span></pre>
+    </details>
+  </details>
+</div>
diff --git a/resources/preamble.html b/resources/preamble.html
index a64832f..bbee91e 100644
--- a/resources/preamble.html
+++ b/resources/preamble.html
@@ -7,7 +7,8 @@
     <span id="translate">
         [ <a title="English version"   href="/index.html">en</a>
         - <a title="Version française" href="/fr/index.html">fr</a>
-        - <a title="Japanese version"  href="/ja/index.html">ja</a> ]
+        - <a title="Japanese version"  href="/ja/index.html">ja</a>
+        - <a title="Chinese version"  href="/cn/index.html">cn</a> ]
     </span>
     <a href="index.html">
       <p class="logo"><img src="/resources/img/org-mode-unicorn.svg" alt="Org-Mode Logo"/> Org Mode</p></a>
-- 
2.41.0


             reply	other threads:[~2023-08-08  6:38 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-08-08  6:21 lux [this message]
2023-08-08  6:54 ` Add a Chinese version to index.org of orgmode.org Ihor Radchenko
2023-08-08  7:43   ` Dr. Arne Babenhauserheide
2023-08-08  9:12     ` Ihor Radchenko
2023-08-08 14:53   ` Ruijie Yu via General discussions about Org-mode.
2023-08-18  6:19     ` lux

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=tencent_D08DCAF386AB0403710ACEFCD4D4D474DF0A@qq.com \
    --to=lx@shellcodes.org \
    --cc=emacs-orgmode@gnu.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).