Hodiaŭ libro povas esti disponebla en kelkaj dosierformoj: HTML, PDF, EPUB, kiel presita libro, ktp. Plej bone, ke ĝi estu disponebla en kiel eble plej multe da formoj por atingi kiel eble la plej grandan nombron da homoj. Tamen ne komfortas redakti kelkajn dosierojn, kiam vi nur volas fari unu ŝanĝon. Por eviti tiun tedan laboron vi povas uzi bazan dosierformon kaj aliformigi ĉi tiun al aliaj formoj per Pandoc.

Vi povas skribi la libron per LibreOffice Writer aŭ per platteksta tekstredaktilo en formoj kiel HTML, LaTeX, Markdown, ktp. Por aliformigi tiun dosieron al alia formo sufiĉus plenumi komandon.

Por ilustri kiel ĉion fari mi montros al vi kiel mi kreas ĉi tiun libron. Kiel versikontrola sistemo mi decidis uzi Giton kaj krei publikan deponejon. Ĝin vi povas kloni plenumante la jenajn komandojn:

sudo apt install git
git clone https://notabug.org/jorgesumle/la-kulturo-estas-libera-historio-de-kontrauproprieta-rezisto

Post vi klonu ĝin vi vidos dosierujon nomitan markdown, tie estas kie la libra teksto troviĝas en Markdown-formo. Instalu Pandoc-on kaj Make-on plenumante sudo apt install make pandoc. Sufiĉas plenumi make html en la radika deponeja dosierujo por krei la HTML-n; por la EPUB-dosierformo oni devas plenumi make epub.

Estas malmultaj kodaj lineoj por krei la HTML- kaj EPUB-formojn. Tamen por krei la PDF-n mi bezonas instali pli da dependoj kaj uzi pli da kodo por krei la redakti LaTeX-dosieron, kiu bone aspektu, kiam ĝi estu aliformigita al PDF. Por fari tion mi aldonis tajloritan LaTeX-kodon (kiu troviĝas en la latex_personalizado-dosierujo) al la LaTeX-dosiero, per kiu mi kreas la PDF-n. Ankaŭ eblas krei belan PDF-dosieron per CSS, ĉar eblas elekti PDF-kreilon bazita sur HTML per la --pdf-engine-opcio.

La dokumentaro de Pandoc estas bona komenca loko por vidi kiel aldoni metadatumojn kaj krei elirdosierojn kiel vi bezonu. Se, kiel mi, vi elektas uzi LaTeX-on por krei la PDF-n, en la Interreto vi trovos dokumentarojn kaj homojn, kiuj proponas solvojn al kutimaj problemoj.

En ĉi tiu artikolo mi montras kiel instali Nginx-servilon, kiu povas plenumi PHP-programojn en Debiano 11.

Unue oni devas instali la sekvajn pakojn:

sudo apt install nginx php php-fpm

Poste oni devas malkomenti la sekvajn liniojn de la defaŭlta agorda dosiero de Nginx (/etc/nginx/sites-available/default):

#location ~ \.php$ {
#   include snippets/fastcgi-php.conf;
#
#   # With php-fpm (or other unix sockets):
#   fastcgi_pass unix:/run/php/php7.4-fpm.sock;
#   # With php-cgi (or other tcp sockets):
#   fastcgi_pass 127.0.0.1:9000;
#}

Tiel estas la rezulto¹:

location ~ \.php$ {
    include snippets/fastcgi-php.conf;

    # With php-fpm (or other unix sockets):
    fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    # With php-cgi (or other tcp sockets):
    #fastcgi_pass 127.0.0.1:9000;
}

Sekve oni devas kontroli se la sintakson de la agorda dosiero estas ĝusta per sudo nginx -t. Se ĝi ne montras eraron, lanĉu la servon de Legu plu el Instali Nginx-servilon kun PHP en Debiano 11