From b87295965ea885c4d50c3ca3460c899b9c7e41b8 Mon Sep 17 00:00:00 2001
From: Aminda Suomalainen <suomalainen+git@mikaela.info>
Date: Thu, 26 Jan 2023 12:08:23 +0200
Subject: [PATCH] =?UTF-8?q?README.tex:=20Add=20an=20English=20section=20de?=
 =?UTF-8?q?scribing=20the=20repo=20and=20how=20to=20LaTeX=20in=20For=C4=9D?=
 =?UTF-8?q?ejo?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Resolves: #1
---
 README.tex | 65 ++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 63 insertions(+), 2 deletions(-)

diff --git a/README.tex b/README.tex
index 470baf6..74c2c12 100644
--- a/README.tex
+++ b/README.tex
@@ -1,6 +1,9 @@
-\documentclass[a4paper]{artikel3}
-\usepackage[finnish]{babel}
+\documentclass[a4paper,colorlinks,linkcolor=blue]{artikel3}
+\usepackage[english,finnish]{babel}
+\usepackage{hyperref}
 \begin{document}
+\hypersetup{urlcolor=blue}
+
 \section*{Testirepo For\^gejon ominaisuuksille}
 
 For\^gejo on Gitea-forkki, joten tällä sivustolla puhutaan välillä Giteasta kun tarkoitetaan For\^gejoa.
@@ -20,4 +23,62 @@ Vastaus vaikuttaa olevan kyllä!
 Miten hattu toisinpäin tehdään?
 Mia\u{u}.
 
+\selectlanguage{english}
+
+\section*{Briefly in English}
+
+This repository is for testing For\^gejo 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.
+
+\subsection*{How do you render \LaTeX in For\^gejo?}
+
+You will need to edit app.ini (note the path of basic.html):
+
+\begin{verbatim}
+[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"
+\end{verbatim}
+
+And basic.html
+
+\begin{verbatim}
+
+
+$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$
+\end{verbatim}
+
+This is addjusted from \texttt{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\^gejo command to render as pdf, see
+\href{https://github.com/go-gitea/gitea/issues/17635}{Gitea\#17635: External renderers to PDF}.
+
 \end{document}