============================================
Ring programming language - Documents folder
============================================

In this folder we have the Ring programming language documentation 

The documentation is created using Sphinx (A popular tool written in Python)

(1) Install Python (Tested using Python 3.6)

(2) Install Sphinx (Tested using v3.1.1) 

(3) To use the pygments lexer, copy ring.py to Python\Lib\site-packages\pygments\lexers

(4) Then run : python _mapping.py

(5) To generate CHM file, Use Microsoft Help Workshop : https://www.microsoft.com/en-us/download/details.aspx?id=21138

(6) To generate PDF file, Use Lyx (https://www.lyx.org/Download) and MiKTEX (https://miktex.org/download)

=======================
for Japanese developers
=======================

日本語版の原稿を用いて LaTeX → PDF 形式の生成はできません。

HelpNDoc を用いて ePubから Microsoft Word 形式へ 変換してください (PDF への変換は文字化けや不正アンカーなどの問題で正常できません)。
その後、 Microsoft Word や LibreOffice で修正後に PDF 形式で出力します。

このディストリビューションに収録されている Microsoft Word 形式は HelpNDoc Personal Edition で生成しました。
Personal 版で生成したファイルは非営利目的・個人利用に制限されています (Nag を消した場合はライセンス違反となる恐れがあります)。
団体・法人など商用利用の場合はHelpNDoc のライセンスをご購入の上、変換処理と修正をしてください。

なお、 HelpNDoc の変換処理完了まで数時間かかります。余裕のあるときに作業することお忘れなく。
