💾 Archived View for tanso.net › diary › 2020-11-16.gmi captured on 2024-06-20 at 12:28:04. Gemini links have been rewritten to link to archived content
-=-=-=-=-=-=-
I've been struggeling with writing installation documentation for customers
lately. Have tried using libreoffice, but it never really works properly for me.
Too much of a distraction to work in a GUI. Also have tried writing markdown in
vimwiki, which I use for all my notes. It kind of works to create PDFs from the
markdown docs using pandoc, and deliver the PDFs to customers -- but it's not
very professional looking. Finally I found a great set of LaTeX templates at our
internal github -- and wow! This is pretty, and so much better to be working in
a proper text editor, focusing on the text instead of the formatting.
My LaTeX skills are quite rusty, haven't used LaTeX since I wrote my CV in it
around 2002. But I'll soon get back into it.
My LaTeX install was done by the following:
============================================================================== $ sudo mkdir /usr/local/texlive/ $ sudo chown janfrode /usr/local/texlive/ $ wget http://mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz $ tar xf http:////mirror.ctan.org/systems/texlive/tlnet/install-tl-unx.tar.gz $ cd install-tl-20201107 $ ./install-tl <wait 53 minutes> ==============================================================================
then add /usr/local/texlive/2020/bin/x86_64-linux to PATH.
My typical workflow is that I create a simple Makefile like:
==============================================================================
document.pdf: document.tex ~/texmf/tex/latex/base/ibmdoc.cls
lualatex --shell-escape document.tex
all: document.pdf
==============================================================================
Then edit my document.tex in vim, make, and view it in evince.
Currently my LaTeX skills seems limited to some simle bullet lists, sections and
subsections, simple tables and using "minted" to show syntax highlighted code or
shell sessions. The LaTeX-ibmdoc-class then takes care of most of the pretty
formatting.