A book/series collection manager plugin for novelyst.
For more information, see the project homepage with description and download instructions.
You can go to the novelyst "discussions" forum and start a thread.
First, you need to know your language code according to ISO 639-1.
For English, this is, for example, en
, for German, it is de
.
NOTE: The procedure described below is greatly simplified if you create a language pack based on the novelyst_xx template and use the tools provided for this purpose.
A "message catalog" is a dictionary for the plugin's messages and menu entries.
For creating a message catalog, you download a template with all English messages from here.
Rename messages.pot
to <your language code>.po
, then give some specific information in the header data by modifying the following lines:
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language: LANGUAGE\n"
NOTE: Be sure to use a text editor that writes utf-8 encoded text. Otherwise, it may not work with non-ASCII characters used in your language.
The <your language code>.po
dictionary is organized as a set of message ID (msgid) - message string (msgstr) pairs, where msgid means the English term, and msgstr means the translated term. This is an example for such a pair where the message string is still missing:
msgid "Cannot overwrite file"
msgstr ""
Now you enter all missing message strings.
- If a message ID contains placeholders like
{}
, be sure to put them also into the message string. - If a message ID starts with
!
, the message string must also start with!
.
Before you distribute your translations, you can convert and install the message catalog for testing.
The plugin needs the message catalog in binary format. This is easily achieved using the msgfmt.py converter script. You find it in your Python installation, in the Tools/i18n subdirectory. If not, you can download the code from here
Name the binary file novelyst_collection.mo.
Add a subdirectory tree to novelyst/locale, and place novelyst_collection.mo there, like this:
<your home directory>
└── .pywriter/
└── novelyst/
└── locale/
└─ <language code>/
└─ LC_MESSAGES/
└─ novelyst_collection.mo
Then start novelyst and see whether your translation works.
NOTE: At startup, novelyst tries to load a message dictionary that fits to the system language. If it doesn't find a matching language code in the locale directory, it uses English as default language.
HINT: novelyst_collection comes with German translations. Look at the de
directory tree, if you need an example.
If novelyst works fine with your translations, you can consider contributing it.
An easy way may be to put a posting in the novelyst forum, appending your <your language code>.po
file.
See https://github.com/peter88213/PyWriter/blob/main/docs/conventions.md
- Python version 3.10.
- Eclipse IDE with PyDev and EGit.
- Apache Ant is used for building the application.
This is Open Source software, and the novelyst_collection plugin is licenced under GPLv3. See the GNU General Public License website for more details, or consult the LICENSE file.