technical_typesetting.md

Technical Typesetting links and tips

• Are we digital typesetting yet?

• Hyperpolyglot: Lightweight Markup: Markdown, reStructuredText, MediaWiki, AsciiDoc, Org-mode

• A template for textbooks in the same style as Algorithms for Optimization

• typst

  • typst.app
    • typst github
    • Typst — современная альтернатива LaTeX
    • A Programmable Markup Language for Typesetting
    • Types and Context

• Accessible LaTeX

• pandoc

  • pandoc binaries
  • installing from hackage

  cabal install pandoc

  • pandoc: Embedded SVG in PDF

    • open: Support SVG images in multiple formats

  • Building pretty slides using Markdown and pandoc

  • Render PDF from Markdown that is using mermaid

• Confluence tips

  • How to migrate a Confluence space to a Markdown Wiki
  • Confluence to Markdown converter which is actually working

• LaTeX tips

  • Can people actually keep up with note-taking in Mathematics lectures with LaTeX?
    • Как я пишу конспекты по математике на LaTeX в Vim
  • Modern LaTeX typesetting
  • PGFPlots?
    tl;dr

  pacman -S texlive-pictures

  • Arch Linux Latin Modern & Latin Modern Math

    yay -S otf-latin-modern
    yay -S otf-latinmodern-math

  • Arch Linux specifics for Cyrillic letters with LaTeX

    pacman -S texlive-langcyrillic
    yay -S ttf-computer-modern-fonts
    yay -S ttf-cm-unicode
    yay -S ttf-pt-fonts
        to fix arch linux Invalid fontname `PT Sans'

    • Problems with Cyrillic fonts in XeTeX

      • Ubuntu

        sudo apt install fonts-cmu
        sudo apt-get install --no-install-recommends xindy-rules po4a texlive-lang-cyrillic texlive-xetex texlive-latex-recommended texlive-latex-extra texlive-fonts-extra latex-xcolor pgf bzr texlive-fonts-recommended ttf-linux-libertine

        • Package algorithm2e on Ubuntu

        sudo apt-get install texlive-science

      • PT Sans, Serif, Mono

        • Install Google Fonts on Ubuntu
          tl;dr

        download from http://rus.paratype.ru/pt-sans-pt-serif and/or https://fonts.google.com/specimen/Open+Sans
        cd /usr/share/fonts
        sudo mkdir googlefonts
        sudo unzip -d . ~/Downloads/Open_Sans.zip
        sudo fc-cache -fv
        fc-match OpenSans
        

      • test file test_cyrillic.tex

      \documentclass{article}
      \usepackage{fontspec}
      \setmainfont{CMU Serif}  
      \begin{document}
      \section{Свои проекты и вклады}
      \emph{Докладчик}Доклад <<С++ без new и delete>>.
      \end{document}

      • test cyrillic letters

      xelatex test_cyrillic.tex
      pandoc --latex-engine=xelatex -V mainfont="Linux Libertine O" unsorted.md -o unsorted.pd
      pandoc --latex-engine=xelatex -V mainfont="PT Sans" unsorted.md -o unsorted1.pdf

      • Problem producing PDF from Cyrillic Markdown + LaTeX
      • И опять шрифты
      • LaTeX support for the fonts PT Sans, PT Serif and PT Mono
        • Общедоступные шрифты с поддержкой национальных алфавитов России

  • 'l3regex.sty' not found

  • Show equation number only once in align environment tl;dr

    \begin{align}
    \begin{split}
      a &= b \\
      &=c \\
      &=d \\
      &=e
    \end{split}
    \end{align}

  • Description list with aligned descriptions

  • Inline code and short verb with minted

  • Positioning of Figures

  • How to center a specific caption?

  • Caption on the side of a figure

    • Minted and floatrow incompatible tl;drfloatrow conflicts with minted

  • LaTeX forum ⇒ Graphics, Figures & Tables ⇒ Subfigures with caption on side

  • How to put two minipages side-by-side, which use 100 % of the text width?

  • itemize, removing natural indent

  • No \citation, \bibdata or \bibstyle commands

  • Beamer Presentation: Figure has no number? tl;dr

    \setbeamertemplate{caption}[numbered]

  • Beamer : remove the number page of the first slide tl;dr

    {
    \setbeamertemplate{footline}{}
    \begin{frame}
    \titlepage
    \end{frame}
    }

  • Customize title of beamer note pages tl;dr

    % Space between paragraphs on notes page
    \addtobeamertemplate{note page}{\setlength{\parskip}{12pt}}{}
    %%\addtobeamertemplate{note page}{\setbeamerfont{itemize/enumerate subbody}{size=\scriptsize}}{}
    %%\addtobeamertemplate{note page}{\setbeamerfont{itemize/enumerate subsubbody}{size=\tiny}}{}

  • What are the main differences between Texmaker and TeXstudio?

    • LaTeX Editors/IDEs

  • buildtexlive

  • Introduction to TeX Live from source

    • Re: [blfs-dev] Possible changes to how we do texlive

  • KaTeX The fastest math typesetting library for the web

    • KaTeX github

  • LaTeX Table Generator

  • Online LaTeX Equation Editor

  • Element-wise (or pointwise) operations notation?

    • List of mathematical symbols
    • Mathematics#List_of_Mathematical_Symbols
      • How do I use a circle as a math accent (larger than \mathring)?
      • how to get good looking copyright and registered symbols

  • Fonts

  • Macros

  • LaTeX/Lengths

  • Import graphics

  • Aligning equations with amsmath

  • Text alignment

  • How to strike out inside LaTeX equations?

  • minted – highlighted source code for LaTeX

    • Code Highlighting with minted -- contains nifty colour styles to choose from

  • Description list with aligned descriptions

  • texblog Lists: Enumerate, itemize, description and how to change them

  • Unicode

    • entering-unicode-characters-in-latex
      • insert-unicode-symbol
    • Fonts (CMU aka Computer Modern Unicode especially)
      • Adding New Fonts to Your System
      • why-does-xetex-not-display-basic-unicode-characters
      • Как сказать XeLaTeX, чтобы использовал шрифты Computer Modern?
      • Using fonts installed in local texlive

  • PDF slides and handouts using Pandoc and Beamer

    • Better-looking LaTeX/Beamer slides
    • verbatim environment does not work with beamer
    • LaTeX beamer: way to change the bullet indentation?

  • The Haskell LaTeX library

    • Convenient Haskell syntax for writing in LaTeX math expressions

  • TeX for Gmail

• MacOS X

  • Missing fonts from LaTeX tl;dr

  \documentclass[]{article}
  
  \usepackage{fontspec}
  \usepackage{polyglossia}
  \usepackage{unicode-math}
  \setmainfont{CMU Serif}
  \setsansfont{CMU Sans Serif}
  \setmonofont{CMU Typewriter Text}
  \setmathfont{Latin Modern Math}
  
  \title{}
  \author{}
  \begin{document}
  Hello, world!
  Привет, мир!
  $ a≡b≠Ω♯$
  $$
  \int_0^\infty x^2\beta d\alpha \omega
  $$
  $$L_{{\Omega ,\nu }}^{\circ }(\nu ,T)={\frac {2{\mathrm {h}}\nu ^{3}}{c^{2}}}{\frac {1}{{\mathrm {e}}^{{{\mathrm {h}}\nu /({\mathrm {k}}T)}}-1}}$$
  \end{document}

• Creating diagrams

  • diagrams using Rust

    • SvgBobRus is an ascii to svg converter tl;dr

    cargo install svgbob_cli
    svgbob < examples/long.bob > long.svg
    svgbob -o long.svg < examples/long.bob
    svgbob examples/long.bob > long.svg

      + [How do I convert an SVG to a PDF on Linux](https://superuser.com/questions/381125/how-do-i-convert-an-svg-to-a-pdf-on-linux)
    

  • ASCII Flow Draw

  • Creating documents with embedded diagrams

    • diagrams

      • project haskell diagrams blog
      • Diagrams 1.3 : what's new
      • blog :: Brent -> [String]
        • About Brent Yorgey
        • diagrams blog
      • diagrams-builder
      • Using Diagrams library in haskell (draw binary trees)
      • Haskell Diagrams wiki
        • Haskell Diagrams backends

      cabal install gtk2hs-buildtools
      cabal install -fcairo diagrams
      cabal --reinstall install -fcairo diagrams
      ghc --make DiagramsTutorial.lhs
      ./DiagramsTutorial -o circle.svg -w 400
      ./DiagramsTutorial -o circle.pdf -w 400
      cat DiagramsTutorial.lhs

      > {-# LANGUAGE NoMonomorphismRestriction #-}
      >
      > import Diagrams.Prelude
      > import Diagrams.Backend.Cairo.CmdLine
      >
      > main = mainWith (circle 1 :: Diagram B)

      The 2nd example : tree rendering

      > import Diagrams.Prelude
      > import Diagrams.Backend.Cairo.CmdLine
      
      We make use of a tree layout module from the diagrams-contrib package:
      
      > import Data.Tree
      > import Diagrams.TwoD.Layout.Tree
      
      + [Diagrams.TwoD.Layout.Tree official documentation](https://hackage.haskell.org/package/diagrams-contrib-1.3.0.8/docs/Diagrams-TwoD-Layout-Tree.html)
      
      > t1 = Node 'A' [Node 'B' (map lf "CDE"), Node 'F' [Node 'G' (map lf "HIJ")]]
      >   where lf x = Node x []
      > 
      > exampleSymmTree =
      >   renderTree ((<> circle 1 # fc white) . text . (:[]))
      >              (~~)
      >              (symmLayout' (with & slHSep .~ 4 & slVSep .~ 4) t1)
      >   # centerXY # pad 1.1
      
      >
      > main = mainWith (exampleSymmTree :: Diagram B)
      

      as exampleSymmTree don't have parameters then there is no {-# LANGUAGE NoMonomorphismRestriction #-} even more with it ghc reports an error:

      [1 of 1] Compiling Main             ( TimersTree.lhs, TimersTree.o )
      
      TimersTree.lhs:16:3:
          Non type-variable argument
            in the constraint: Renderable (Path V2 n) b
          (Use FlexibleContexts to permit this)
          When checking that ‘exampleSymmTree’ has the inferred type
            exampleSymmTree :: forall n b.
                               (RealFloat n, Data.Typeable.Internal.Typeable n,
                                Renderable (Path V2 n) b,
                                Renderable (Diagrams.TwoD.Text.Text n) b) =>
                               QDiagram b V2 n Any

      • A pandoc filter to express diagrams inline using the haskell EDSL diagrams.
      • modules not found when installed via Nix #7

      cabal install diagrams-pandoc
      cabal install SVGFonts

      • A PGF backend for diagrams

      cabal install diagrams-pgf

      • an example of customized tree rendering

      > text' (timer_name, func_name) = ((text ( timer_name ++ "\n\n")) # fc blue # fontSize (local 0.4)) === ((text ( func_name )) # fc green # italic # bold)Shared/Common/Src/CuttingLine/
      > mybox' (timer_name, func_name) = let wid = fromIntegral(length func_name)*0.3 in (text' (timer_name, func_name)) <> roundedRect wid 2 0.1 # fc gold
      > exampleSymmTree =
      >   renderTree mybox'
      >              (~~)
      >              (symmLayout' (with & slHSep .~ 8 & slVSep .~ 7) t1)
      >   # centerXY # pad 1.1 # fontSize (local 0.3)

      • User’s Guide to the PGF Package

      • The tree of function calls made by a naive Fibonacci implementation

      • Basic diagram with text, boxes and arrows

      • Diagrams Gallery

      • Flowchart sample

      • Interactive windows for displaying Haskell-generated diagrams

      • Haskell Diagrams double lined arrows

      • CSE230 Wi14 - Programming With Effects (monads)

    • Unordered tuples and type algebra

  • Embedded diagrams in pandoc's markdown

  • PlantUML

• Support LaTeX environments in Markdown -> HTML conversion #1938

• use dillinger for markdown formatting

• Package algorithm2e on Ubuntu: sudo apt-get install texlive-science

• Syntax highlighting in markdown

• math in markdown: Survey of syntaxes for math in markdown

  • Schlolarlymarkdown: make academic writing less frustrating
  • github repo for scholdoc

• Vector Drawing Editors

  • asymptote
    • Fill a triangle in space using asymptote
    • Asymptote: Drawing
      • dvips error unknown keyword
      • Errors "File `foo_0' not found." and "Unknown keyword ("foo_0".eps)" resolved
        • grffile does not work with LuaTeX any more
        • tl;dr temporary workaround

        sudo pacman -U https://archive.archlinux.org/packages/a/asymptote/asymptote-2.48-1-x86_64.pkg.tar.xz
        add to /etc/pacman.conf
        IgnorePkg = asymptote

        • How To Fix “invalid or corrupted package (PGP signature)” Error In Arch Linux

        sudo pacman -S archlinux-keyring

  • Inkscape
  • GLE - for drawing logical gates / electrical diagrams