txt2tags

Tu będą notatki nt. fenomenalnego programiczku txt2tags, który pozwala na konwersję z prostej metody zapisu w pliku tekstowym na HTML, LaTeX oraz wiele innych.

• CzytSzyt Little Girl - składnia w pigułce

Tytuł dokumentu
Autora Imię i Nazwisko
Data modyfikacji: %%mtime(%A %B %d, %Y)
%!encoding: utf-8
%!style(tex): polski
%%%%%%% Footnotes (przypisy to potrójny nawias!!! %%%%%%%
%%%% For manage Footnotes in LaTeX
%!postproc(tex): \(\(\((.*?) \\footnote{\1
%!postproc(tex): \)\)\) }
%%%% For manage Footnotes in HTML
%!postproc(html): \(\(\( <small>(
%!postproc(html): \)\)\) )</small>

%%%%%%% Footnotes (przypisy to potrójny nawias!!! %%%%%%%
%%%% For manage Footnotes in LaTeX
%!postproc(tex): \(\(\((.*?) \\footnote{\1
%!postproc(tex): \)\)\) }
%%%% For manage Footnotes in HTML
%!postproc(html): \(\(\( <small>(
%!postproc(html): \)\)\) )</small>

Należy umieścić to w polu konfiguracji pliku t2t

%%% wstawianie tagów LaTeX
%!preproc(tex): \\ SSS
%!preproc(tex): { BBB
%!preproc(tex): } ZZZ
%!postproc(tex): SSS \\
%!postproc(tex): BBB {
%!postproc(tex): ZZZ }

I można używać składni LaTeXa do wstawiania dowolnego prostego znacznika, np. przypisy:

Blala ba blabla\footnote{to nie o to chodzi} bla brum.

Wygląda na to, że txt2tags ma jakiś błąd w interpretacji tytulariów, więc najlepiej od razu zmienić deklarację documentclass na polską i wyższej ligi niż „article”…

%!postproc(tex): documentclass[11pt,a4paper]{article} documentclass[10pt,a4paper]{mwrep}

Podobnym postprocem można zmieniać inne tagi LaTeXa.

Jak powiedziałem wyżej, postprocem można wyszukiwać i zmieniać znaki, których nie przetworzył txt2tags:

%%%%% Przetwarzanie znaków typograficznych
%%% cudzysłów
%!postproc(html): ,, „
%!postproc(html): \'\' ”
%%% półpauza i myślnik (wg notacji LaTeX)
%!postproc(html): --- —
%!postproc(html): -- –
%!postproc(txt): --- —
%!postproc(txt): -- –

Inkludowanie dotyczyć może tylko obszaru body. Próby wklejenia ustawień pliku (czyli obszaru header) nie powiodą się.

%!include: intro.t2t
%!include: chapter1.t2t
%!include: chapter2.t2t

Więcej strzegółów tutaj.

  Headers           First 3 lines of the source file
  Title             = words =
  Numbered title    + words +
  Comment           % comments
  Separator line    -----------------------...
  Strong line       =======================...
  Image             [filename.jpg]
  Link              [label url]
  
  Bold              **words**
  Italic            //words//
  Underline         __words__
  Strike            --words--
  Monospaced        ``words``
  Raw               ""words""
  Tagged            ''words''
  
  Paragraph         words
  Quote             <TAB>words
  List              - words
  Numbered list     + words
  Definition list   : words
  Table             | cell1 | cell2 | cell3...
  
  Verbatim line     ``` words
  Raw line          """ words
  Tagged line       ''' words
  
  Verbatim block    ```
                    lines
                    ```
  Raw block         """
                    lines
                    """
  Tagged block      '''
                    lines
                    '''