org-multilingual

Introduction

Org Mode multilingual preprocessor.

How to use

1. Download source code

   git clone https://github.com/mrlee23/org-multilingual.git
       

2. Add to load-path

   (add-to-list 'load-path "./org-multilingual")
   (require 'org-multilingual)
       

3. Execute

(org-multilingual-replace "Hello @@LANG_EN:World@@@@LANG_ES:Mundo@@!" 'es) ;; "Hello Mundo!"

with Publish

(defun org-my-publish-to-html (plist filename pub-dir)
  (org-html-publish-to-html plist
                            (org-multilingual-publish plist filename pub-dir)
                            pub-dir))
(setq org-publish-project-alist
        `(("Project Name"
           :base-directory "BASE_DIR"
           :base-extension "org"
           :auto-index nil
           :exclude: "EXCLUDE_DIR"
           :index-filename nil
           :index-title nil
           :auto-sitemap nil
           :publishing-directory "TARGET_DIR"
           :publishing-function org-my-publish-to-html
           :headline-levels 4
           :recursive nil
           :auto-preamble nil
           )
          ))

Syntax

Property

Replace section name with value of “LANG_XX” property. The property value will be trim left, right spaces.

Remaining not “LANG_XX” properties is remaning.

• :LANG_<ISO Code>:

Example

*** This is test
:PROPERTIES:
:LANG_EN: Section Name
:LANG_ES: Nombre de la sección
:LANG_KO: 섹션 이름
:LANG_ZH: 部分名称
:LANG_JA: セクション名
:END:

	Results
English	Section Name
Español	Nombre de la sección
한국어	섹션 이름
中文	部分名称
日本語	セクション名
Others	Section

Block

• #+BEGIN_LANG <ISO Code>

Example

Contents

contenido

내용

内容

内容

	Results
English	Contents
Español	contenido
한국어	내용
中文	内容
日本語	内容
Others

Multiple languages

Contents
内容

	Results
English	Contents
Español	Contents
한국어	内容
中文	内容
日本語	内容
Others

Inline

• #+LANG_<ISO Code>:

Example

#+LANG_EN: Hello World!
#+LANG_ES: Hello Mundo!
#+LANG_KO: 안녕 World!
#+LANG_ZH: 你好 World!
#+LANG_JA: こんにちは World!

	Results
English	Hello World!
Español	Hello Mundo!
한국어	안녕 World!
中文	你好 World!
日本語	こんにちは World!
Others

Quoting

• @@LANG_<ISO Code>: @@

Example

Hello @@LANG_EN:World@@!
Hello @@LANG_ES:Mundo@@!
@@LANG_KO:안녕@@ World!
你好 @@LANG_ZH:World@@!
こんにちは @@LANG_JA:World@@!

	Results
English	Hello World!
Español	Hello Mundo!
한국어	안녕 World!
中文	你好 World!
日本語	こんにちは World!
Others

Options

• :language
• :override