Krasina   README

Interlingue

Pri ti projecte

Scope

Crear un libre digital in EPUB e altri formates de Krasina, un rakonta original in Interlingue, scrit de Jan A. Kajš in 1938, quel esset ja digitalisat de Bedŕich Plavec secun li textu original e convertet de Thomas Schmidt in formate PDF in 2013.

Autor

Marcos Cruz, 2019, 2020.

Web-loc

ne.alinome.net.

Qualmen constructer li libre

Si vu ne posse atender li liberation del sequente version, vu self posse constructer li libre-documentes.

In prim, ples confirmar que li programas listat in li section "Requirements" (besones) del document <Makefile> es instalat in vor sistema.

Tande ples intrar in li documentiere del projecte e comandar make secun ti exemples:

Comande Efecte

make

Constructer li formates recomandat

make all

Constructer omni formates

make azw3

Constructer li AZW3

make dbk

Constructer li DocBook

make epub

Constructer li EPUB (omni variantes)

make epuba

Constructer li EPUB per Asciidoctor EPUB3 (recomandat)

make epubd

Constructer li EPUB per dbtoepub (sin covriment)

make epubp

Constructer li EPUB per Pandoc

make epubx

Constructer li EPUB per xsltproc (equivalent a dbtoepub)

make html

Constructer li HTML

make md

Constructer li Markdown de Pandoc

make odt

Constructer li OpenDocument (sin covriment)

make pdf

Constructer li PDF (ambi grandores)

make pdfa4

Constructer li PDF de grandore DIN A4 (recomandat)

make pdfl

Constructer li PDF de grandore «letter»

Li documentes es creat in li documentiere <target>.

Nómines del documentes final

Quande omni documentes final es constructet (talmen anc contenet in e li liberaturas che GitHub e li archives descargabil ex ne.alinome.net), li contenete del documentiere <target> es ti:

  • krasina.adoc._a4.pdf

  • krasina.adoc._letter.pdf

  • krasina.adoc.dbk

  • krasina.adoc.dbk.dbtoepub.epub

  • krasina.adoc.dbk.pandoc.epub

  • krasina.adoc.dbk.pandoc.odt

  • krasina.adoc.dbk.xsltproc.epub

  • krasina.adoc.epub

Li nómines es self-explicatori: Ili indica li operation de conversion de formates ex li documente fontal de Asciidoctor, li convertores usat e li variantes de stil o grandore por li formates final (DocBook, EPUB, OpenDocument e PDF). Ultra to, ti convention nominal prevente futur colisiones de nómines, si plu convertores o formates vel esser adjuntet al projecte.

English

Abouth this project

Goal

Make an e-book in EPUB and other formats of Krasina, an original story in Interlingue, written by Jan A. Kajš in 1938, which was already digitalized by Bedŕich Plavec after the original text and converted into PDF format by Thomas Schmidt in 2013.

Author

Marcos Cruz, 2019.

Website

ne.alinome.net.

How to build the book

If you cannot wait for the release of the next version, you can build the target files yourself.

First, make sure the programs listed under the "Requirements" section of the <Makefile> file are installed in your system.

Then enter the project’s directory and give the make command as follows:

Command Effect

make

Build the recommended formats

make all

Build all formats

make azw3

Build the AZW3

make dbk

Build the DocBook

make epub

Build the EPUB (all variants)

make epuba

Build the EPUB with Asciidoctor EPUB3 (recommended)

make epubd

Build the EPUB with dbtoepub (no cover page)

make epubp

Build the EPUB with Pandoc

make epubx

Build the EPUB with xsltproc (equivalent to dbtoepub)

make html

Build the HTML

make md

Build the Pandoc’s Markdown

make odt

Build the OpenDocument (no cover page)

make pdf

Build the PDF (both sizes)

make pdfa4

Build the PDF (DIN A4 size) (recommended)

make pdfl

Build the PDF (letter size)

The documents are built in the <target> directory.

Names of the target files

When all target files are built (as included in the GitHub releases and in the corresponding archives downloadable from ne.alinome.net), the contents of the <target> directory are the following:

  • krasina.adoc._a4.pdf

  • krasina.adoc._letter.pdf

  • krasina.adoc.dbk

  • krasina.adoc.dbk.dbtoepub.epub

  • krasina.adoc.dbk.pandoc.epub

  • krasina.adoc.dbk.pandoc.odt

  • krasina.adoc.dbk.xsltproc.epub

  • krasina.adoc.epub

The names are self-explanatory: They indicate the format conversion process from the Asciidoctor source document, the converters used and the style or size variants of the final formats (PDF, DocBook, EPUB and OpenDocument). Beside, this naming convention prevents name clashes in the future, if more tools or formats are added to the project.