Dblatex’s customization files for typesetting institutional papers in Russia

This files is intended to customize dblatex to conversion DocBook to LaTeX with layout required for educational works (reports, articles, etc) in Russian institutes.

Motivation

The standard algorithm of preparing educational documents in MS Word has some advantages:

1. It allows quickly create and print documents;

2. Changing in text immediately displays in GUI;

3. There is possibility to automatically generation of ToC, LoT, etc.

But typesetting documents in .docx format has some disadvantages:

1. The difficulty of correcting incorrectly configured styles;

2. The need to customize layout for each new documents;

3. Captions for tables and figures needs to be added manually.

Therefore most peoples choose LaTeX to prepare thesis, because it opens the following possibilities:

1. The document layout is separated from content, that allows reuse layout for more than one document;

2. Sections headers is automatically indexed, and ToC is generated.

3. More easily typesetting mathematical equations.

But typesetting documents in LaTeX has some disadvantages:

1. Bulky syntactic constructions for environments, in-text commands;

2. Compatibility issues with some abandoned packages;

3. The changing in document are not displayed immediately.

There is other decision, that partially solves of thees disadvantages: semantic markup.

Method

First, the document typed in AsciiDoc is converted to DocBook with asciidoctor. Then, docbook document converted to LaTeX file by dblatex with -T gost option.

Installation

Just copy all files into ~/.dblatex

HOW to use

To make .pdf from .adoc file: asciidoctor -b docbook5 -o - article.adoc | dblatex -T gost-article -o article.pdf -.

License

Copyright (c) 2022, Lev O. Vorobyov.

This files provided as-is, without any warranty of reliability. You may copy, modify and redistribute this files without any restrictions but with one condition: the above copyright notice will be saved.