Różnice

Różnice między wybraną wersją a wersją aktualną.

--- txt:txt2tags [2014/10/22 08:50] – utworzono flamenco
+++ txt:txt2tags [2022/05/22 10:38] (aktualna) – edycja zewnętrzna 127.0.0.1
@@ Linia 7: / Linia 7: @@
 ===== config =====
+==== config na początku pliku ====
+<code>
+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>
+</code>
 ==== preproc i postproc ====
+=== Przypisy czyli footnotes ===
+<code>
+%%%%%%% 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>
+</code>
+=== wstawianie dowolnych tagów LaTeXa ===
+Należy umieścić to w polu konfiguracji pliku t2t
+<code>
+%%% wstawianie tagów LaTeX
+%!preproc(tex): \\ SSS
+%!preproc(tex): { BBB
+%!preproc(tex): } ZZZ
+%!postproc(tex): SSS \\
+%!postproc(tex): BBB {
+%!postproc(tex): ZZZ }
+</code>
+I można używać składni LaTeXa do wstawiania dowolnego prostego znacznika, np. przypisy:
+<code>
+Blala ba blabla\footnote{to nie o to chodzi} bla brum.
+</code>
+=== Zmiana documentclass LaTeX ===
+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"...
+<code>
+%!postproc(tex): documentclass[11pt,a4paper]{article} documentclass[10pt,a4paper]{mwrep}
+</code>
+Podobnym ''postproc''em można zmieniać inne tagi LaTeXa.
+=== Poprawianie znaków typograficznych ===
+Jak powiedziałem wyżej, postprocem można wyszukiwać i zmieniać znaki, których nie przetworzył txt2tags:
+<code>
+%%%%% Przetwarzanie znaków typograficznych
+%%% cudzysłów
+%!postproc(html): ,, „
+%!postproc(html): \'\' ”
+%%% półpauza i myślnik (wg notacji LaTeX)
+%!postproc(html): --- &mdash;
+%!postproc(html): -- &ndash;
+%!postproc(txt): --- —
+%!postproc(txt): -- –
+</code>
+==== Wstawianie czyli inkludowanie innych plików tekstowych ====
+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 [[http://txt2tags.org/userguide/includecommand.html|tutaj]].
+===== html2txt2tags konwerter HTML do t2t =====
+To się przydawać może, kiedy chcę zrobić np. kopię tekstu z jakiejś strony WWW i wrzucić sobie tutaj (zrobiłem tak np. z **[[txt:carroll_jabberwocky|tą stronką]]**). Albowiem wtedy muszę użyć:
+<code>
+## wget http://strona.pl/strona.htm
+## html2txt2tags strona.htm > strona.t2t
+## txt2tags -t doku strona.t2t
+</code>
-=== preproc ===
+==== INSTALACJA ====
+Zainstalować najsampierw ''html-wikiconverter'' i ''curl''.
+<code># sudo apt-get install libhtml-wikiconverter-perl curl</code>
-=== postproc ===
+I dalej:
+<code>
+# cpan install HTML::WikiConverter::Txt2tags
+</code>
+W wypadku porażki, trzeba to zrobić ręcznie, tj. ze strony http://www.cpan.org/authors/id/E/EF/EFORGEOT/ wejść do ''HTML-WikiConverter-Txt2tags'' pobrać plyk ''tar.gz'' i...:
+<code>
+# tar -zxvf HTML-WikiConverter-Txt2tags-0.04.tar.gz
+# cd HTML-WikiConverter-Txt2tags-0.04
+# perl Makefile.PL
+# make
+# make test
+# make install
+</code>
+Można też dobrać się do ''html2txt2tags'' i skopiować go sobie gdzieś do $PATH.
+==== GDYBY INSTALLACJA NIE ZADZIAŁAŁAŁA... ====
+... Spróbować jeszcze tego:
+<code>
+(sam interface)
+% perl -MCPAN -e 'install HTML::WikiConverter'
+(dialekty)
+% perl -MCPAN -e 'install Bundle::HTMLWikiConverter'
+(indywidualne instalacje dialektów)
+% perl -MCPAN -e 'install HTML::WikiConverter::MediaWiki'
+% perl -MCPAN -e 'install HTML::WikiConverter::Txt2tags'
+</code>
+Coś zadziała, musi. **SZCZEGÓLNIE, KIEDY WSPOMOŻEMY SIĘ UPRAWNIENIAMI ROOTA CZYLI SUDO!!!**
+===== markup =====
+<code>
+  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
+                    '''
+</code>