testi/README.tex

Tämän repon pääosoite on https://git.piraattipuolue.fi/mikaela/testi

Testirepo Forĝejon ominaisuuksille

Forĝejo on Gitea-forkki, joten tällä sivustolla puhutaan välillä Giteasta kun tarkoitetaan Forĝejoa.

Tässä repossa on mukana myös:

• ChatGPT:llä leikkimisen tuloksena syntyneitä LaTeX-asiakirjoja, joista voinee ehkä ottaa mallia tulevaisuudessa.

• Git submoduuli-testi, josta löytyy taidokkaampi StreetComplete-flaikku.

Kysymyksiä

Voinko kirjoittaa LaTeXia? Vastaus vaikuttaa olevan kyllä!

Miten hattu toisinpäin tehdään? Miaŭ.

Briefly in English

The canonical address for this repository is https://git.piraattipuolue.fi/mikaela/testi

This repository is for testing Forĝejo features, mainly LaTeX rendering. And to that end I have played a lot with ChatGPT so I have fun documents to maybe take inspiration from in the future.

How do you render LaTeX in Forĝejo?

You will need to edit app.ini (note the path of basic.html):

[markup.latex]
ENABLED         = true
FILE_EXTENSIONS = .tex,.latex
# docs maybe suggest adding --katex, but is anyone doing math? https://docs.gitea.io/en-us/external-renderers/
RENDER_COMMAND  = "timeout 30s pandoc -f latex -t html --self-contained --template /etc/gitea/basic.html"

And basic.html

$for(include-before)$
$include-before$
$endfor$
$if(title)$
$title$
$if(subtitle)$
$subtitle$
$endif$
$for(author)$
$author$
$endfor$
$if(date)$
$date$
$endif$
$endif$
$if(toc)$
$idprefix$TOC
$if(toc-title)$
$toc-title$
$endif$
$table-of-contents$
$endif$
$body$
$for(include-after)$
$include-after$
$endfor$

This is adjusted from pandoc -D html (mainly stripping HTML and HEAD), by improving it, it could likely look even better.

Could this be better? I would like to give Forĝejo command to render as pdf, see Gitea#17635: External renderers to PDF.