t2html — online w chmurze

PROGRAM:

IMIĘ

t2html - Prosty konwerter tekstu na HTML. Opiera się na regułach wcięć tekstu.

STRESZCZENIE

t2html [opcje] plik.txt > plik.html

OPIS

Konwertuj czyste pliki tekstowe na ładnie wyglądające strony HTML, prawdopodobnie w ramkach. Przykład
konwersja:

1. Zwykły tekstowy kod źródłowy
http://pm-doc.git.sourceforge.net/git/gitweb.cgi?p=pm-doc/pm-doc;a=blob_plain;f=doc/index.txt;hb=HEAD

2. Reusult konwersji z niestandardową opcją --css-file:
http://pm-doc.sourceforge.net/pm-tips.html
http://pm-doc.sourceforge.net/pm-tips.css

3. Tryb Emacsa tinytf.el do zapisywania plików tekstowych (opcjonalnie)
https://savannah.nongnu.org/projects/emacs-tiny-tools

wymagania dla dotychczasowy wkład Ascii pliki

Plik musi być zapisany w formacie technicznym, którego układ jest opisany w this
podręcznik. Zasadniczo pomysł jest prosty i istnieją tylko dwa poziomy nagłówków: jeden w kolumnie 0
a drugi w kolumnie 4 (w połowie szerokości tabulatora). Standardowy tekst zaczyna się od kolumny
8 (pozycja po naciśnięciu klawisza tabulacji).

Idea formatu technicznego polega na tym, że każda kolumna reprezentuje inny układ renderowania w
wygenerowany kod HTML. W pliku tekstowym nie są potrzebne żadne specjalne znaczniki, więc można użyć formatu
wersja tekstowa jako wzorcowa kopia FAQ itp. Punktory, listy numerowane, wyróżnienia słów i
cytat itp. można wyrazić w naturalny sposób.

HTML opis

Wygenerowany kod HTML zawiera osadzony kaskadowy arkusz stylów 2 (CSS2) i mały fragment pliku
Kod Javy. CSS2 służy do kolorowania układu strony i określenia odpowiedniego druku
rozmiary czcionek. Wygenerowany HTML przyjmuje również podejście do obsługi XHTML. Zobacz stronę
http://www.w3.org/TR/xhtml1/#guidelines, w których znajdują się zalecenia dotyczące zgodności wstecznej
są zarysowane:

Wymagany prawny HTML XHTML
..



XHTML nie obsługuje identyfikatorów fragmentów #foo z elementem „name”, ale używa „id”
Zamiast. Dla kompatybilności wstecznej oba elementy są zdefiniowane:

< ..name="tag"> Jest teraz <.. name="tag" id="tag">

UWAGA: Ten program nigdy nie był przeznaczony do użycia w XHTML i ścisłej ważności XHTML
nie należy się tego spodziewać.

Motywacja

Najłatwiejszym formatem do pisania dużych dokumentów, takich jak często zadawane pytania, jest tekst. Oferta pliku tekstowego
WysiWyg i można go łatwo przekształcić w format HTML. Pliki tekstowe są łatwe
utrzymywane i nie ma wymagań dotyczących specjalnych edytorów tekstu. Dowolny edytor tekstu, np
notatnik, vi, Emacs mogą być używane do przechowywania dokumentów.

Pliki tekstowe są również jedynym sensownym formatem, jeśli dokumenty są przechowywane pod kontrolą wersji
jak RCS, CVS, SVN, Arch, Perforce, ClearCase. Można je łatwo porównać z diff i
łaty można łatwo odbierać i wysyłać do nich.

Aby ułatwić obsługę dużych dokumentów, dostępny jest również plik Emacs tryb pomocniczy, pakiet
o nazwie tinytf.el, który oferuje czcionkę tekstu za pomocą kolorów, kontrolę wcięć, punktor
wypełnianie, zmiana numeracji nagłówków, znaczniki słów, podświetlanie składni itp. Zobacz projekt
http://freshmeat.net/projects/emacs-tiny-tools

OPCJE

HTML: Nagłówek oraz Footer Opcje
--jak jest
Wszelkie dodatkowe formatowanie HTML lub manipulowanie tekstem jest pomijane. Tekst jest zachowywany bez zmian
pojawia się w pliku Użyj tej opcji, jeśli planujesz dostarczyć lub wydrukować tekst w widoczny sposób.

o Jeśli plik zawiera „Spis treści”, nie jest on usuwany
o Blok spisu treści nie jest tworzony (zwykle tak by było)

--autor -a STR
Autor dokumentu np --autor "Jan Łania"

--zrzeczenie się odpowiedzialności FILE
Tekst, który pojawia się w stopce, jest odczytywany z tego pliku. Jeśli nie podano wartości domyślnej
dodano tekst dotyczący praw autorskich. Opcje „--quiet” i „--simple” wyłączają zastrzeżenia.

--dokument FILE
Imię i nazwisko dokumentu lub nazwy pliku. Możesz wyświetlić listę wszystkich alternatywnych adresów URL dokumentu
z tą opcją.

--e-mail -e E-MAIL
Adres kontaktowy autora dokumentu. Musi to być czysty adres e-mail bez numeru
Zawiera znaki „<” i „>”. Np. --e-mail foo@example.com

--e-mail "ja@here.com>" ŹLE
--e-mail "ja@here.com" Prawidłowy

--prosty -s
Drukuj tylko minimalną stopkę: kontakt, adres e-mail i data. Użyj „--quiet”, aby całkowicie
odrzuć stopkę.

--t2html-tagi
Zezwalaj na przetwarzanie osadzonych #T2HTML- dyrektywy wewnątrz pliku. Zobacz pełne wyjaśnienie
czytając temat „WBUDOWANE DYREKTYWY W TEKŚCIE”. Domyślnie nie musisz tego robić
podaj tę opcję - domyślnie jest "włączona".

Aby zignorować dyrektywy osadzone w pliku tekstowym, podaj opcję „nie”: --not2html-tagi.

--tytuł STR -t STR
Tekst tytułu wyświetlany w górnej ramce przeglądarki.

--url URL

Lokalizacja pliku HTML. Gdy --dokument podał nazwę, to daje lokalizację. Ten
informacje są drukowane w stopce.

HTML: Nawigacja urls
--baza URL
Lokalizacja adresu URL pliku HTML w formacie miejsce przeznaczenia witryna internetowa gdzie będzie udostępniony.
Ta opcja jest potrzebna tylko wtedy, gdy dokument jest przechowywany na serwerze FTP (rzadko, ale
możliwy). Dokument oparty na serwerze FTP nie może używać linków do spisu treści (fragment
#etykietka identyfikatory), chyba że zdefiniowano również znacznik HTML BASE.

Argumentem może być pełny adres URL dokumentu:

--baza ftp://ftp.example.com/plik.html
--baza ftp://ftp.example.com/

--przycisk-nagłówek-góra
Dodaj dodatkowe [Toc] przycisk nawigacyjny do końca każdego nagłówka. To może być przydatne
w długich plikach HTML bez ramek.

--zapinana na guziki URL
Przyciski są umieszczone na górze dokumentu w kolejności: [poprzedni][górny][następny] i
--przycisk-* opcje definiują adresy URL.

Jeśli adres URL jest łańcuchem Żaden wtedy żaden przycisk nie jest włożony. Może to być przydatne, jeśli przyciski są
zdefiniowany przez osobny program. I przykład użycia Perla:

#!/usr/bin/perl

mój $top = "indeks.html"; # ustaw wartości domyślne
mój $prev = "brak";
mój $następny = "brak";

# ... gdzieś $prev lub $next mogą zostać ustawione, a potem nie

qx(t2html --button-top "$top" --button-prev "$poprzedni" --button-next "$następny" ...);

# Koniec przykładowego programu

--przycisk-poprzedni URL
Adres URL, aby przejść do poprzedniego dokumentu lub ciągu znaków Żaden.

--button-dalej URL
Adres URL, aby przejść do następnego dokumentu lub ciągu znaków Żaden.

--referencja tag=wartość
Możesz dodać dowolne niestandardowe odniesienia (tagi) w tekście i sprawić, by rozwinęły się do dowolnej wartości.
Ta opcja może być podana wiele razy i każde wystąpienie TAG jest zastępowane przez
WARTOŚĆ. Np. gdy podane są następujące opcje:

--reference "#URL-STRONY DOMOWEJ=http://www.example.com/dir"
--reference "#ARCHIWUM-URL=http://www.example.com/dir/dir2"

Gdy występuje odwołanie w tekście, wygenerowany kod HTML zawiera rozszerzone rozszerzone do wartości. Jakiś
przykładowy tekst:

Strona główna to #HOME-URL/page.html, a strona Mirrot, na której się znajduje
#ARCHIVE-URL/page.html, gdzie można znaleźć najnowszą wersję.

-R, --referencja-separator STRING
Patrz wyżej. Ciąg używany do rozdzielenia TAG i VALUE. Domyślnie jest to znak równości "=".

-T, --toc-url-print
Wyświetlaj adresy URL (utworzone z nagłówków), które tworzą spis treści (NAME
znaczniki AHREF) w dokumencie. Lista jest wyprowadzana na stderr, więc może być
rozdzielony:

% t2html --toc-url-print tmp.txt > plik.html 2> toc-list.txt

Gdzie byś tego potrzebował? Jeśli chcesz wiedzieć, jaki fragment identyfikuje twój plik,
potrzebujesz listy nazwisk.

http://www.example.com/myfile.html#identyfikator-fragmentu

HTML: Sterowanie CSS generacja (HTML stoły)
--kod-css-bg
Ta opcja wpływa na sposób renderowania sekcji kodu (kolumna 12). Normalnie sekcja
otoczony jest a .. kody, ale dzięki tym opcjom coś więcej
hodowca jest używany. Kod jest opakowany w a ... i tło
kolor jest ustawiony na odcień szarości.

--css-kod-notatka "REGEXP"
Option --kod-css-bg jest wymagany do aktywacji tej opcji. Specjalne słowo zdefiniowane za pomocą
regexp (domyślnie jest to „Uwaga:”) specjalnie oznaczy sekcje kodu. „Pierwsze słowo” to
dopasowane do dostarczonego wyrażenia regularnego Perla.

Podane wyrażenie regularne nie może, powtarzać, nie może zawierać żadnych pasujących operatorów grupowych.
Oznacza to po prostu, że nawiasy grupujące, takie jak "(jeden|dwa|trzy)" są niedozwolone.
Musisz użyć niegrupujących Perla, takich jak "(?:jeden|dwa|trzy)". Proszę odnieść się do perla
stronę podręcznika [perlre], jeśli ten krótki wstęp nie dał wystarczająco dużo liny.

Dzięki tym opcjom zamiast renderowania tekstu w kolumnie 12 za pomocą .. , tekst
pojawia się jak zwykły tekst, ale z niespodzianką. Kolor tła tekstu ma
został zmieniony na ciemnoszary, aby wizualnie wyróżnić się z tekstu.

Przykład wyjaśni. Załóżmy, że przeszedłeś opcje --kod-css-bg oraz
--css-code-note='(?:Uwaga|Uwaga):', który polecił potraktować pierwsze akapity o godz
kolumna 12 inaczej. Lubię to:

To jest zwykły tekst, który pojawia się gdzieś w kolumnie 8.
Może zawierać kilka wierszy tekstu w tym akapicie.

Uwaga: Oto sekcja specjalna, w kolumnie 12,
a pierwsze słowo w tym akapicie to „Uwaga:”.
Tylko to czyni ten akapit w kolumnie 12 wyjątkowym.

Teraz mamy kod do pokazania użytkownikowi:

dla ( ja = 0; i++; ja < 10 )
{
// Robienie czegoś w tej pętli
}

Jedna notatka, tekst zapisany początkowym słowem specjalnym, takim jak „Uwaga:”, musi mieścić się w jednej
pełny pragram. Wszelkie inne akapity, które następują po nich, są renderowane jako sekcje kodu. Tak jak
tutaj:

Jest to zwykły tekst, który pojawia się gdzieś
Może zawierać kilka wierszy tekstu w tym akapicie

Uwaga: Oto sekcja specjalna, w kolumnie 12,
a pierwsze słowo w tym akapicie to „Uwaga:”
co czyni go wyjątkowym

Jednak ten akapit NIE JEST renderowany specjalnie
nie więcej. Tylko pierwszy akapit powyżej.

dla ( ja = 0; i++; ja < 10 )
{
// Robienie czegoś w tej pętli
}

Jakby tego było mało, istnieją specjalne dyrektywy kontroli tabeli, które pozwalają
kontrolujesz .. który jest umieszczony wokół sekcji kodu w kolumnie 12.
Oto kilka przykładów:

Oto przykład 1

#t2html::td:bgcolor=#F7F7DE

dla ( ja = 0; i++; ja < 10 )
{
// Robienie czegoś w tej pętli
}

Oto przykład 2

#t2html::td:bgcolor=#F7F7DE:tableborder:1

dla ( ja = 0; i++; ja < 10 )
{
// Robienie czegoś w tej pętli
}

Oto przykład 3

#t2html::td:bgcolor="#FFFFFF":tableclass:przerywany

dla ( ja = 0; i++; ja < 10 )
{
// Robienie czegoś w tej pętli
}

Oto przykład 4

#t2html::td:bgcolor="#FFFFFF":table:border=1_width=94%_border=0_cellpadding="10"_cellspacing="0"

dla ( ja = 0; i++; ja < 10 )
{
// Robienie czegoś w tej pętli
}

Wygląda tajemniczo? Nic na to nie poradzę, abyście w pełni zrozumieli, co
te dyrektywy robią, musisz zrozumieć, jakie elementy można dodać do
I żetony. Informacje o dostępnych atrybutach można znaleźć w specyfikacji HTML. Tutaj jest
instruktaż, co możesz zrobić:

Komenda startowa to:

#t2html::
|
Po tym następują pary atrybutów w postaci klucz:wartość
i wiele z nich jako klucz1:wartość1:klucz2:wartość2 ...

Pary „klucz:wartość” mogą być:

td: ATRYBUTY
|
To jest konwertowane na

tabela: ATRYBUTY
|
To jest konwertowane na

W ATRYBUTACH nie może być spacji, ponieważ „Pierwsze słowo” musi być jedno
sąsiadujące słowo. Zamiast spacji można użyć podkreślenia:

tabela:obramowanie=1_width=94%
|
Interpretowane jako

Możliwa jest również zmiana domyślnego stylu CLASS za pomocą słowa „tableclass”. W celu
KLASA, aby była użyteczna, jej definicje CSS muszą być domyślne
konfiguracji lub dostarczane z pliku zewnętrznego. Zobacz opcję --plik-skryptu.

klasa tabeli: nazwa
|
Interpretowane jako

Na przykład istnieje kilka domyślnych stylów, których można użyć:

1) Oto przykład „przerywanej” KLASY

#t2html::tableclass:przerywane

dla ( ja = 0; i++; ja < 10 )
{
// Robienie czegoś w tej pętli
}

2) Oto przykład „solidny” KLASY:

#t2html::tableclass:solid

dla ( ja = 0; i++; ja < 10 )
{
// Robienie czegoś w tej pętli
}

Możesz zmienić dowolną indywidualną wartość domyślnej definicji tabeli, która jest:



Aby zmienić np. tylko wartość cellpadding, powiedziałbyś:

#t2html::table:tablecellwypełnienie:2

Jeśli nie jesteś pewien, o co w tym wszystkim chodziło, po prostu uruchom program z --strona-testowa
i spójrz na źródła i wygenerowane pliki HTML. To powinno oferować więcej liny
eksperymentować z.

--plik-css FILE
Włączać który odnosi się do zewnętrznego źródła definicji stylu CSS. Ta opcja
jest ignorowany, jeśli --plik-skryptu została podana opcja, ponieważ ta opcja importuje całość
treść wewnątrz tagu HEAD. Ta opcja może pojawić się wiele razy i zewnętrzny CSS
pliki są dodawane w podanej kolejności.

--css-typ-czcionki DEFINICJA CSS
Ustaw definicję czcionki elementu BODY na CSS-DEFINITION. Domyślną używaną wartością jest
zwykły skład używany w gazetach i książkach:

--css-font-type='rodzina-font: "Times New Roman", serif;'

--css-rozmiar-czcionki DEFINICJA CSS
Ustaw rozmiar czcionki elementu body na CSS-DEFINITION. Domyślny rozmiar czcionki jest wyrażony
w punktach:

--css-font-size="rozmiar czcionki: 12pt;"

HTML: Sterowanie dotychczasowy ciało of dokument
--kasować REGEXP
Usuń wiersze pasujące do perla REGEXP. Jest to przydatne, jeśli używasz jakiegoś narzędzia do obsługi dokumentów
używa znaczników nawigacyjnych w pliku tekstowym, których nie chcesz wyświetlać w wygenerowanym pliku
HTML.

--usuń nagłówki e-maili
Usuń nagłówki wiadomości e-mail na początku pliku, aż do pierwszego pustego wiersza rozpoczynającego plik
ciało. Jeśli przechowujesz dokument gotowy do publikowania wiadomości w sieci Usenet, mogą one zawierać
nagłówki i treść:

Z: ...
Grupy dyskusyjne: ...
Informacje o nadawcy X:
Podsumowując:

TEKST

--nodelete-default
Użyj tej opcji, aby wyłączyć domyślne usuwanie tekstu (które jest włączone).

Pakiet Emacsa „folding.el” i vi mogą być używane z dowolnym tekstem lub językiem programowania
umieść sekcje tekstu między znacznikami {{{ oraz }}. Możesz otwierać lub zamykać takie fałdy.
Pozwala to na utrzymanie porządku i łatwe zarządzanie dużymi dokumentami. Dla Emacsa
wsparcie, zob. ftp://ftp.csd.uu.se/pub/users/andersl/beta/

Wartość domyślna usuwa te znaczniki i specjalne komentarze „#_comment”, które ją tworzą
istnieje możliwość dodania własnych notatek, które nie są uwzględniane w generowanym wyjściu.

{{{ Sekcja bezpieczeństwa

#_comment Upewnij się, że zmieniłeś tę sekcję na
#_skomentuj następną wersję

Bezpieczeństwo to ważna kwestia w codziennej administracji...
Więcej tekstu...

}}

--html-ciało STR
Dodatkowe atrybuty do dodania do tagu HTML . Możesz np. zdefiniować język pliku
tekst z --html-ciało JĘZYK=en który wygenerowałby znacznik HTML Widzieć
sekcja „ZOBACZ TAKŻE” dla ISO 639.

--html-column-beg="SPEC HTML-SPEC"
Domyślną interpretację kolumn 1,2,3 5,6,7,8,9,10,11,12 można zmienić za pomocą
żebrać oraz zakończenia przełączniki. Kolumny 0,4 nie mogą być zmieniane, ponieważ są zarezerwowane dla
nagłówki. Oto kilka próbek:

--html-column-beg="7cytat "
--html-column-end="7cytat"

--html-column-beg="10 klasa='kolumna10'"
--html-column-end="10 "

--html-column-beg="cytat "
--html-column-end="cytat"

Uwaga: Możesz podać specyfikacje tylko do kolumny 12. Jeśli tekst jest poza kolumną
12, jest interpretowany tak, jak w kolumnie 12.

Oprócz numeru kolumny, SPEC może być również jednym z następujących ciągów

Specjalny odpowiednik znaczników słownych
------------------------------
cytat `'
pogrubiony _
empa *
mały +
duży =
ref [] jak: [Michael] odnosi się do [rfc822]

Inne dostępne specyfikacje
------------------------------
7quote Gdy kolumna 7 zaczyna się od podwójnego cudzysłowu.

Aby zapoznać się z wartościami arkuszy stylów dla każdego koloru, patrz klasa atrybut i zastosowanie --plik-skryptu
możliwość importu definicji. Zwykle plik /usr/lib/X11/rgb.txt zawiera listę możliwych wartości kolorów
oraz standard HTML pod adresem http://www.w3.org/ definiuje następujące standardowe nazwane kolory:

Czarny #000000 Bordowy #800000
Zielony #008000 Granatowy #000080
Srebrny #C0C0C0 Czerwony #FF0000
Limonkowy #00FF00 Niebieski #0000FF
Szary #808080 Fioletowy #800080
Oliwkowy #808000 Turkusowy #008080
Biały #FFFFFF Fuksja #FF00FF
Żółty #FFFF00 Aqua #00FFFF

--html-column-end="KOL HTML-SPEC"
See --html-kolumna-pocz

--html-czcionka ROZMIAR
Zdefiniuj ROZMIAR CZCIONKI. Przydatne może być ustawienie większego rozmiaru czcionki dla prezentacji.

-F, --html-ramka [PARAMETRY RAMKI]
Jeśli zostanie podany, zostaną wygenerowane trzy oddzielne pliki HTML. Lewa ramka będzie zawierać
Spis treści i prawa ramka zawierają resztę tekstu. The PARAMETRY RAMKI może być dowolny ważny
parametry znacznika HTML FRAMESET. Wartość domyślna to „cols="25%,75%"".

Używanie tego implikuje --na zewnątrz automatycznie, ponieważ nie można wydrukować trzech plików
na stdout.

plik.html

--> file.html Plik ramki, wskaż tutaj przeglądarkę
file-toc.html Lewa ramka (nawigacja)
file-body.html Prawa ramka (zawartość)

--język ID
Użyj identyfikatora języka, dwuznakowego identyfikatora ISO, takiego jak „en” dla języka angielskiego podczas
generacja HTMLa. Ma to wpływ tylko na tekst wyświetlany użytkownikowi końcowemu, na przykład tekst
„Spis treści”. Ustawieniem domyślnym jest „pl”. Patrz rozdział „ZOBACZ TAKŻE”, aby zapoznać się ze standardami
ISO 639 i ISO 3166 dla odpowiednich kodów.

Wybrany język zmienia wewnętrzne tablice programu na dwa sposoby: 1) Zamiast
domyślny nagłówek „Tabela okentów” będzie używany jako odpowiednik w języku narodowym 2)
Tekst „Pic” poniżej osadzonych kolejno ponumerowanych obrazów będzie używany w języku narodowym
odpowiednik.

Jeśli twój język nie jest obsługiwany, wyślij frazę „Spis treści” i
słowo „Pic” w twoim języku do opiekuna.

--plik-skryptu FILE
Dołącz kod Java, który musi być kompletny z pliku. Kod jest
włóż do środka każdego kodu HTML.

--plik-skryptu to ogólny sposób importowania czegokolwiek do elementu HEAD. Np. Jeśli
chcesz zachować osobne definicje stylów dla wszystkich, możesz zaimportować tylko wskaźnik
do arkusza stylów. Widzieć 14.3.2 Określanie zewnętrzny styl pościel w standardzie HTML 4.0.

--meta-słowa kluczowe STR
Metasłowa kluczowe. Używany przez wyszukiwarki. Oddziel słowa kwy, takie jak „AA, BB, CC”, za pomocą
przecinki. Zapoznaj się ze specyfikacją HTML 4.01 i tematem „7.4.4 Metadane” i zobacz
http://www.htmlhelp.com/reference/wilbur/ oraz

--meta-keywords "AA,BB,CC"

--meta-opis STR
Metaopis. Dołącz ciąg opisu, maksymalnie 1000 znaków. To jest używane przez
Wyszukiwarki. Zapoznaj się ze specyfikacją HTML 4.01 i tematem „7.4.4 Metadane”

--nazwa-uniq
Pierwsze 1-4 słowa z nagłówka są używane w kodzie HTML Nazwa tagi. Jednak tak jest
możliwe, że dwa takie same nagłówki zaczynają się od dokładnie tych samych 1-4 słów. W tych przypadkach
musisz włączyć tę opcję. Użyje licznika 00 - 999 zamiast słów z
nagłówki do konstruowania kodu HTML Nazwa Bibliografia.

Proszę korzystać z tej opcji tylko w sytuacjach awaryjnych, ponieważ odnosi się to do skoku bloku Nazwa przez

httpI://example.com/doc.html#nazwa_nagłówka

jest wygodniejsze niż używanie niejasnych odniesień

httpI://example.com/doc.html#11

Ponadto za każdym razem, gdy dodajesz nowy nagłówek, zmienia się numer, natomiast symboliczny
nazwa wybrana z nagłówka pozostaje tak długo, jak długo nie zmienisz nagłówka. Myśleć o
dobro Twoich internautów, którzy dodają Twoje strony do zakładek. Staraj się, aby nagłówki nie miały
te same przedmioty i nie potrzebujesz tej opcji.

dokument konserwacja oraz partia praca Polecenia
-DO, --automatyczne wykrywanie
Konwertuj plik tylko wtedy, gdy w pliku zostanie znaleziony znacznik „#T2HTML-”. Ta opcja jest przydatna, jeśli ty
uruchom polecenie wsadowe, aby przekonwertować wszystkie pliki na HTML, ale tylko jeśli wyglądają jak baza HTML
plików:

znajdować . -nazwa "*.txt" -wpisz f
-exec t2html --auto-detect --verbose --out {} \;

Polecenie przeszukuje wszystkie pliki *.txt w bieżącym katalogu i przekazuje je do
program konwersji. The --automatyczne wykrywanie konwertuje tylko pliki zawierające „#T2HTML-”
dyrektywy. Inne pliki tekstowe nie są konwertowane.

--sprawdzenie-linku -l
Sprawdź wszystkie łącza http i ftp. Niniejsze opcja is domniemany do be biegać standalone Option
--cichy ma specjalne znaczenie, gdy jest używany z sprawdzaniem łącza.

Dzięki tej opcji możesz regularnie sprawdzać poprawność dokumentu i usuwać martwe linki lub
zaktualizuj przeniesione linki. Problematyczne linki są wysyłane do stderr. Sprawdź ten link
jest dostępna tylko wtedy, gdy masz zainstalowaną bibliotekę internetową LWP. Program będzie
sprawdź, czy masz go w czasie wykonywania.

Linki, które są duże, np. które pasują tar.gz .zip ... lub które uruchamiają programy (łącza z
? znak) są ignorowane, ponieważ żądanie GET użyte do sprawdzenia zwróciłoby całość
treść linku i tak by się stało. być zbyt drogie.

Sugestia: kiedy umieszczasz linki binarne w swoich dokumentach, dodaj je ze spacją:

http://example.com/dir/dir/ nazwa_pliku.tar.gz

Potem program robi sprawdź adresy http. Użytkownicy mogą nie być w stanie pobrać pliku
jednym kliknięciem sprawdzający może zweryfikować przynajmniej katalog. Jeśli nie jesteś właścicielem
link, możliwe jest również, że plik został przeniesiony lub ma nową nazwę wersji
pojawiło się.

-L, --link-check-single
Wydrukuj skondensowane dane wyjściowe w grep -n jak sposób PLIK:LINIA:WIADOMOŚĆ

Ta opcja łączy tekst odpowiedzi adresu URL w jedną linię, dzięki czemu można go wyświetlić
wiadomości w jednej linii. Możesz użyć narzędzi programistycznych (takich jak kompilacja Emacs Mx).
może przeanalizować standardową składnię grep, aby przejść do lokalizacji w dokumencie, aby poprawić
linki później.

-o, --na zewnątrz
zapisz wygenerowany kod HTML do pliku, który pochodzi z nazwy pliku wejściowego.

--out --print /katalog/plik --> /katalog/plik.html
--out --print /katalog/plik.txt --> /katalog/plik.html
--out --print /katalog/plik.ten.txt --> /katalog/plik.ten.html

--pamięć-linków PLIK_CACHE
Gdy linki są sprawdzane okresowo, sprawdzanie każdego linku byłoby dość rygorystyczne
za każdym razem, gdy już się udało. Aby zaoszczędzić czas na sprawdzanie łącza, przycisk „ok”
łącza mogą być buforowane w osobnym pliku. Następnym razem, gdy sprawdzisz linki, pamięć podręczna jest
otwierane i sprawdzane są tylko znalezione łącza, które nie znajdowały się w pamięci podręcznej. To powinno
radykalnie poprawić długie wyszukiwania. Rozważ ten przykład, w którym znajduje się każdy plik tekstowy
sprawdzane rekurencyjnie.

$ t2html --link-check-single
--quiet --link-cache ~tmp/link.cache
`znaleźć. -nazwa "*.txt" -wpisz f`

-O, --out-reż DIR
Jak --na zewnątrz, ale posiekaj część katalogu i zapisz pliki wyjściowe do DIR. Następujące
wygeneruje plik HTML do bieżącego katalogu:

--out-dir.

Jeśli masz zautomatyzowane narzędzie, które wypełnia katalog, możesz użyć słowa Żaden do
zignoruj ​​tę opcję. Poniższe jest no-op, nie wygeneruje danych wyjściowych do katalogu
"nic":

--out-dir brak

-P, --wydrukować
Wydrukuj nazwę pliku na stdout po przetworzeniu HTML. Normalnie program nie drukuje nazw plików,
tylko wygenerowany kod HTML.

% t2html --out --drukuj stronę.txt

--> strona.html

-P, --print-url
Drukuj nazwę pliku w formacie adresu URL. Jest to przydatne, jeśli chcesz sprawdzić układ
natychmiast za pomocą przeglądarki.

% t2html --out --print-url page.txt | xargs ryś

--> plik: /users/foo/txt/page.html

--podział REGEXP
Podziel dokument na mniejsze części, gdy REGEXP pasuje. Split Polecenia jest standalone,
co oznacza, że ​​zaczyna się i kończy. Brak konwersji HTML dla pliku.

Jeśli REGEXP zostanie znalezione z linii, jest to punkt początkowy podziału. Np. podzielić
zgodnie z nagłówkami najwyższego poziomu, które nie mają numeracji, użyłbyś:

--split '^[AZ]'

Do wygenerowanych części składowych dodawane są kolejne liczby, składające się z 3 cyfr:

nazwa_pliku.txt-NNN

Funkcja podziału jest przydatna, jeśli chcesz generować slajdy z każdego nagłówka: Najpierw
podziel dokument, następnie przekonwertuj każdą część na HTML i na koniec wydrukuj każdą część (stronę)
oddzielnie do drukarki.

-S1, --podział1
To jest skrót myślowy --podział Komenda. Zdefiniuj wyrażenie regularne do podziału na nagłówek najwyższego poziomu.

-S2, --podział2
To jest skrót myślowy --podział Komenda. Zdefiniuj wyrażenie regularne, aby podzielić na nagłówek drugiego poziomu.

-SN, --podzielone-nazwane-pliki
Dodatkowa dyrektywa dla poleceń split. Jeśli podzielisz np. Według nagłówków, używając --podział1,
bardziej pouczające byłoby generowanie nazw plików według kilku pierwszych słów z
nazwa nagłówka. Załóżmy, że nazwy nagłówków, w których występuje podział, to:

Wytyczne dotyczące programu
Podsumowanie

Wtedy wygenerowane częściowe nazwy plików byłyby następujące.

NAZWA PLIKU-program_guidelines
NAZWA PLIKU — wniosek

-X, --xhtml
Renderuj przy użyciu ścisłego XHTML. Oznacza to używanie , i używać akapitów .. .

„Uwaga: ta opcja jest eksperymentalna. Zobacz BŁĘDY”

Różne Opcje
--odpluskwić POZIOM
Włącz debugowanie z dodatnim numerem LEVEL. Zero oznacza brak debugowania.

--help -h
Wydrukuj ekran pomocy. Kończy program.

--help-css
Drukuj domyślny użyty CSS. Kończy program. Możesz kopiować i modyfikować te dane wyjściowe oraz
poinstruuj, aby użyć własnego z --css-file=PLIK. Możesz także osadzić opcję w plikach
z dyrektywą „#T2HTML-OPTION”.

--pomoc-html
Wydrukuj pomoc w formacie HTML. Kończy program.

--pomoc-człowiek
Wydrukuj stronę pomocy w formacie strony podręcznika systemu Unix. Chcesz przekazać to wyjście do nroff -człowiek
aby go przeczytać. Kończy program.

--strona-testowa
Wydrukuj stronę testową: HTML i przykładowy plik tekstowy demonstrujący możliwości.

--czas
Wydrukuj na stderr czas poświęcony na obsługę pliku.

-v, --gadatliwy [POZIOM]
Drukuj pełne wiadomości.

-Q, --cichy
Nie drukuj żadnej stopki. Ta opcja ma inne znaczenie, jeśli --sprawdzenie-linku Jest opcja
włączone: drukuj tylko błędne linki.

V, --wersja
Wydrukuj informacje o wersji programu.

FORMAT OPIS

Program konwertuje pliki tekstowe do formatu HTML. Podstawową ideą jest poleganie na poziomie wcięcia i
zastosowany układ nosi nazwę „Format techniczny” (TF), w którym zastosowano tylko minimalne konwencje
do zaznaczania tekstu kursywą, pogrubieniem itp. Podstawowe zasady można zademonstrować poniżej. Ogłoszenie
linijka poisiton kolumny u góry:

--//-- początek opisu

123456789 123456789 123456789 123456789 123456789 numery kolumn

Nagłówek 1 zaczyna się dużą literą w skrajnej lewej kolumnie 1

Pozycje kolumn 1,2,3 są obecnie niezdefiniowane i mogą nie być zdefiniowane
sformatować poprawnie. Nie umieszczaj tekstu w kolumnach 1,2 lub 3.

Nagłówek poziomu 2 zaczyna się od połowy tabulatora w kolumnie 4 z dużą literą

Normalny, ale kolorowy tekst w kolumnach 5

Normalny, ale kolorowy tekst w kolumnach 6

Nagłówek 3 można rozważyć na pozycji TAB minus 1, kolumna 7.

„Specjalny tekst w kolumnie 7 zaczyna się podwójnym cudzysłowem”

Standardowy tekst zaczyna się od kolumny 8, możesz *wyróżnić* tekst lub
zrób to _strong_ i napisz =SmallText= lub +BigText+ pokaż
nazwa zmiennej `ThisIsAlsoVariable'. Możesz `_*zagnieździć*_' `the'
narzut. więcej txt w tym akapicie txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
tekst tekst

Silny tekst w kolumnie 9

Kolumna 10 jest zarezerwowana dla cytatów
Kolumna 10 jest zarezerwowana dla cytatów
Kolumna 10 jest zarezerwowana dla cytatów
Kolumna 10 jest zarezerwowana dla cytatów

Silny tekst w kolumnie 11

Kolumna 12 i kolejne są zarezerwowane dla przykładów kodu
Kolumna 12 i kolejne są zarezerwowane dla przykładów kodu
Cały tekst tutaj jest otoczony przez kody HTML
Na tę kolumnę KOD wpływają opcje --css-code*.

Ponownie nagłówek 2 w kolumnie 4

Jeśli chcesz uzyskać coś w rodzaju nagłówka poziomu 3, użyj kolumny 7 (pogrubiona)

Kolumna 8. Standardowa pozycja tabulatora. txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt
[1998 Pan Foo powiedział]:

cytowany tekst cytowany tekst cytowany tekst cytowany tekst cytowany tekst
tekst cytowany tekst cytowany tekst cytowany tekst cytowany tekst
cytowany tekst cytowany tekst cytowany tekst cytowany tekst cytowany tekst
cytowany tekst

* Punktor w kolumnie 8. Zwróć uwagę na 3 spacje po (*), więc
tekst zaczyna się od połowy tabulacji do przodu w kolumnie 12.
* Pocisk. txt txt txt txt txt txt txt txt txt txt txt txt
* Pocisk. txt txt txt txt txt txt txt txt txt txt txt txt
,txt txt txt txt

Zauważ, że poprzedni akapit kończy się na P-przecinek
kod, mówi temu akapitowi, aby kontynuować
tryb wypunktowania, w przeciwnym razie ten tekst w kolumnie 12
byłoby interpretowane jako sekcja kodu surrpoundedn
przez kody HTML.

. To jest uporządkowana lista.
. To jest uporządkowana lista.
. To jest uporządkowana lista.

.Ta linia zaczyna się od kropki i jest wyświetlana osobno.
.Ta linia zaczyna się od kropki i jest wyświetlana osobno.

!! To dodaje Kod HTML, tekst w wierszu jest oznaczony symbolem
!!

Ustaw ten adres e-mail jako klikalnykonto@tt.com> Nie
aby ten adres e-mail był klikalny bar@example.com, ponieważ to
to tylko przykład, a nie prawdziwy adres. Zauważ, że
ostatni nie był otoczony przez <>. Popularne nazwy logowania, takie jak
foo, bar, quux lub „przykład” strony internetowej są ignorowane
automatycznie.

Również nie rób this@example.com> bo jest ekstra
Biała przestrzeń. Może to być wygodniejszy sposób wyłączenia poczty e-mail
adresy tymczasowo.

Nagłówek 1 ponownie w kolumnie 0

Podtytuł w kolumnie 4

I zwykły tekst, kolumna 8 txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt txt
txt txt txt txt txt txt txt txt txt txt txt

--//-- koniec opisu

To tyle, tam jest opisany cały układ. Bardziej formalnie zasady tekstu
formatowanie opisano poniżej.

UŻYWANE NAGŁÓWKI
· Są tylko drugiej poziomy nagłówków w tym stylu. Kolumny nagłówków to 0 i 4 oraz
nagłówek musi zaczynać się od dużej litery lub cyfry

· w kolumnie 4, jeśli tekst zaczyna się małą literą, wiersz ten jest interpretowany jako


· HTML znak jest dodawany tuż przed drukowaniem nagłówka na poziomie 1.

· Nagłówki są gromadzone, tworzony jest spis treści i wstawiany na początek kodu HTML
strona. HTML odniesienia używane w spisie treści to pierwsze 4 kolejne słowa z
nagłówki. Upewnij się, że nagłówki mają unikalne nazwy, w przeciwnym razie będą takie same
Odwołania NAME w wygenerowanym kodzie HTML. Spacje są zamieniane na podkreślenia kiedy
łącząc słowa. Jeśli nie możesz pisać unikalnych nagłówków za pomocą czterech słów, musisz to zrobić
posługiwać się --nazwa-uniq wyłącznik

TEKST INWESTYCJE ZASADY

Ogólne
Podstawowe zasady pozycjonowania tekstu w określonych kolumnach:

· Tekst w kolumnie 0 jest niezdefiniowany, jeśli nie zaczyna się od dużej litery lub cyfry
wskazać poziom nagłówka 1.

· Tekst między kolumnami 1-3 jest oznaczony symbolem

· Kolumna 4 jest zarezerwowana dla poziomu nagłówka 2

· Tekst między kolumnami 5-7 jest oznaczony symbolem

· Tekst w kolumnie 7 dotyczy sytuacji, gdy pierwszy znak jest podwójnym cudzysłowem.

· Kolumna 10 jest zarezerwowana na tekst. Jeśli chcesz kogoś zacytować lub dodać referencje
tekst, umieść tekst w tej kolumnie.

· Teksty w kolumnach 9,11 są oznaczone symbolem

Kolumna 8 na tekst i kody specjalne

· Kolumna 8 jest zarezerwowana dla zwykłego tekstu

· Na początku tekstu, w kolumnie 8, może znajdować się kod DOT lub COMMA.

Kolumna 12 jest szczególna

· Kolumna 12 jest traktowana specjalnie: blok zaczyna się od a linie są oznaczone jako
. Kiedy ostatnia wiadomość o godz kolumna 12 zostanie znaleziony, blok jest zamknięty
Zwróć uwagę na następujący przykład

txt txt txt ;równo ułożony blok, dobrze, zrób to tak
tekst tekst

txt txt txt txt ;Nie można zakończyć /pre, ponieważ last
txt txt txt txt ;kolumna nie jest na 12
txt txt txt txt

txt txt txt txt
txt txt txt txt
txt txt txt txt
;; Kończąc komentarz, teraz tekst jest równomiernie umieszczony

Dodatkowy tokeny dla posługiwać się at kolumna 8
· Jeśli na początku wiersza znajduje się „.”(kropka) i bezpośrednio nie są to białe znaki, to
kod jest dodawany na końcu linii.

Ta linia będzie miała Znacznik HTML na końcu.
Podczas gdy te dwie linie są ze sobą połączone
przez przeglądarkę, w zależności od szerokości ramki.

· Jeśli jest ","(przecinek), to kod nie jest wstawiany, jeśli poprzednia linia jest
pusty. Jeśli używasz zarówno „.”(kropka), jak i „”,(przecinek), muszą one być w kolejności kropka-przecinek. The
","(przecinek) działa inaczej, jeśli jest używany w punktorach

A jest zawsze dodawany, jeśli istnieje separacja akapitów, ale kiedy piszesz a
punktor, jest problem, ponieważ punktor istnieje tylko tak długo, jak przechowywany jest tekst
razem

* To jest punktor i zawiera cały tekst razem
nawet jeśli w kuli jest inna linia.

Ale aby pisać wypunktowania, które rozciągają się na wiele akapitów, musisz poinstruować, że tak jest
trzymać się razem, a tekst w następnym akapicie nie podczas gdy jest umieszczony na
kolumna 12

* To jest punktor i zawiera cały tekst razem
, nawet jeśli punktor zawiera inną linię.

To jest nowy akapit do poprzedniego punktu i to jest
nie próbka tekstu. Zobacz ciąg dalszy kodu COMMA powyżej.

* To jest nowy punktor

// a to jest przykładowy kod po punkcie
if ( $ flaga ) { ..zrób coś... }

Specjalny XNUMX znakowania
kursywa, pogrubienie, kod, małe, duże żetony
_to_ jest interpretowane jako to
*to* jest interpretowane jako to
`to' jest interpretowane jako Ten `

Modyfikatory Exra, które można mieszać z powyższymi. Zwykle, jeśli chcesz mieć większą czcionkę,
PISAĆ SŁOWA WIELKIMI LITERAMI.

=to= jest interpretowane jako to
+to+ jest interpretowane jako to
[to] jest interpretowane jako to

indeks górny
słowo [to] jest interpretowane jako indeks górny. Możesz użyć jak
this[1], wielokrotny [(2)] i prawie dowolny [(ab)] i
można sobie wyobrazić [IV superskrypty] tak długo, jak po lewej stronie
nawias jest dołączony do słowa.

indeksowanie
12[[10]] jest reprezentacją wartości 12 o podstawie 10.
Jest to interpretowane jako indeks dolny. Możesz użyć jak
ten[[1]], wielokrotny[[(2)]] i prawie dowolny[[(ab)]] i
można sobie wyobrazić[[IV superskrypty]] tak długo, jak zostały *dwa*
nawiasy są dołączone do słowa.

osadzanie standardowych tokenów HTML
Standardowe specjalne jednostki HTML mogą być dodawane wewnątrz tekstu w normalny sposób, albo za pomocą
nazwy symboliczne lub kod skrótu. Oto przykłady:

× < > ≤ ≥ ≠ √ -
α β γ ÷
« » ‹ › - – —
≈ ≡ ∑ ƒ ∞
° ±
™ © ®
€ £ ¥

osadzanie PURE HTML w tekście
Niniejsze cecha is wysoko eksperymentalny. Możliwe jest osadzenie czystego kodu HTML w tekście
przypadkach, gdy np. potrzebne jest specjalne formatowanie. Zasada jest prosta: ty piszesz
HTML jak zwykle, ale podwój każdy znak „<” i „>”, na przykład:

< >

Inną zasadą jest to, że cały PURE HTML musi być trzymany razem. Nie może być żadnej linii
przerwy między czystymi liniami HTML. To jest niepoprawne:

<

< > jeden
< > dwa

< >

Czysty kod HTML musi być napisany bez dodatkowych znaków nowej linii:

<
< > jeden
< > dwa
< >

To „podwojenie” wpływa również na normalne zasady pisania tekstu. Jeśli piszesz dokumenty,
tam, gdzie opisujesz dokumenty HERE w stylu uniksowym, NIE WOLNO umieszczać tokenów obok
nawzajem:

bash$ kot<
pierwszej
EOF

Musisz napisać powyższy przykład kodu, używając spacji, aby uniemożliwić interpretację „<<”.
jako CZYSTY HTML:

bash$ kot << EOF # PRAWO, dodaj spacje
pierwszej
EOF

rysowanie krótkiego separatora
A !! (dwa wykrzykniki) w kolumnie tekstowej (pozycja 8) powoduje natychmiastowe dodanie
kod. dowolny tekst po !! w tym samym wierszu jest zapisywane i wstawiane
tuż po kod, dlatego polecenia formatowania słów nie mają na to wpływu
Linia.

Http oraz E-mail Oznakowanie kontrola
· Wszystkie odniesienia do http i ftp, jak równieżfoo@example.com> adresy e-mail są zaznaczone
możliwe do kliknięcia. E-mail musi zawierać otaczające znaki <>, aby został rozpoznany.

· Jeśli adres URL jest poprzedzony łącznikiem, nie będzie można go kliknąć. Jeśli ciąg foo, bar, quux,
test, strona zostanie znaleziona z adresu URL, to nie jest liczona jako klikalna.

<ja@here.com> klikalne
http://example.com możliwe do kliknięcia

< ja@here.com> nie można kliknąć; zawiera przestrzeń
<5dko56$1@news02.deltanet.com> Message-Id, nie można kliknąć

-http://example.com myślnik, nie można go kliknąć
http://$EXAMPLE variable. not clickable

wykazy oraz kule
· Tabela biuletynów jest zbudowana, jeśli w kolumnie 8 i 3 odstępach po niej znajduje się „o” lub „*”
tak, aby tekst zaczynał się od kolumny 12. Zaleca się trzymanie wierszy wypunktowanych razem;
brak odstępów między blokami pocisków.

· Uporządkowana lista zaczyna się od „.”, kropki i jest zapisywana jak punktor, w którym zaczyna się tekst
w kolumnie 12.

Linia przerwy
· Wszystkie podziały wierszy są widoczne w dokumencie, nie używaj więcej niż jednego podziału wiersza
osobne paragrafy.

· Bardzo ważne jest to, że istnieje tylko pierwszej podział linii po nagłówkach.

WBUDOWANY DYREKTYWY INSIDE TEKST

Opcje wiersza poleceń
Możesz anulować przestrzeganie wszystkich wbudowanych dyrektyw, podając opcję --not2html-tagi.

Możesz dołączyć te wiersze w dowolnym miejscu w dokumencie, a ich zawartość zostanie uwzględniona
Wyjście HTML. Każda linia dyrektywy musi mieścić się w jednej linii i nie można jej przerwać
oddzielne linie.

#T2HTML-TITLE
#T2HTML-EMAIL
#T2HTML-AUTOR
#T2HTML-DOC
#T2HTML-METAKEYWORDS
#T2HTML-METADESCRIPTION

Możesz przekazać opcje wiersza poleceń osadzone w pliku. Jakbyś chciał KOD
sekcji (kolumna 12) do pokolorowania odcieniem szarości, można dodać:

#T2HTML-OPCJA --css-code-bg

Możesz też poprosić o włączenie określonych opcji. Zauważ, że każda linia jest dokładnie
ponieważ przekazałeś argument w wierszu poleceń. Wyobraź sobie, że otaczają cię podwójne cudzysłowy
wokół linii, które są argumentami powiązanych opcji.

#T2HTML-OPTION --tak jak jest
#T2HTML-OPTION --cichy
#T2HTML-OPTION --język
#T2HTML-OPTION pl
#T2HTML-OPCJA --css-type-type
#T2HTML-OPTION Trebusz MS
#T2HTML-OPCJA --css-code-bg
#T2HTML-OPTION --css-code-notatka
#T2HTML-OPTION (?:Uwaga|Uwaga|Ostrzeżenie):

Możesz również osadzić własne komentarze w tekście. Te są usuwane:

#T2HTML-COMMENT Tutaj komentujesz
#T2HTML-COMMENT Masz tutaj kolejny komentarz

Osadzanie plików
#INCLUDE- polecenie

Służy do włączenia treści do bieżącej bieżącej pozycji. Adres URL może być a
odwołanie do nazwy pliku, gdzie każdy $VAR jest zastępowany ze zmiennych środowiskowych. The
rozwinięcie tyldy(~) nie jest obsługiwane. Dołączona nazwa pliku to system operacyjny
obsługiwane położenie ścieżki.

Przedrostek „raw:” wyłącza normalne formatowanie. Zawartość pliku jest dołączana w takiej postaci, w jakiej jest.

Adres URL może być również odwołaniem HTTP do zdalnej lokalizacji, której zawartość jest uwzględniona
w punkcie. W przypadku zawartości zdalnej lub gdy nazwa pliku kończy się na rozszerzeniu ".html" lub
„.html”, treść jest usuwana w celu włączenia treści
możliwy. Na poniższym zdjęciu widoczne są tylko linie w obrębie CIAŁA oznaczone symbolem !!
w zestawie:



...


ten tekst !!
i więcej tego!!



Przykłady:

#INCLUDE-$HOME/lib/html/picture1.html
#WŁĄCZAĆ-http://www.example.com/code.html
#INCLUDE-raw:przyklad/kod.html

Osadzanie zdjęć
Komenda #PIC służy do umieszczania obrazków w tekście

#PIC picture.png#Tekst podpisu#Atrybuty HTML obrazu#wyrównaj#
(1) (2) (3) (4)

1. NAZWA lub adres URL zdjęcia. Polub obrazek/to.png

2. Tekst, który pojawia się pod obrazkiem

3. Dodatkowe atrybuty, które są dołączone wewnątrz etykietka.
Dla , linia by
czytać:

#PIC some.png#Tekst podpisu#width=200 length=200##

4. Pozycja obrazu: „lewo” (domyślnie), „środek”, „prawo”

Uwaga: „Tekst podpisu” stanie się również tekstem ALT obrazu, który jest używany
w przypadku, gdy przeglądarka nie jest w stanie wyświetlić zdjęć. Możesz ukryć tekst ALT
z opcją --brak-obrazu-alt.

Identyfikatory fragmentów dla nazwanych znaczników
Polecenie #REF służy do odwoływania się do HTML tag wewnątrz bieżącego dokumentu. The
całe polecenie musi być umieszczone w jednym wierszu i nie może być podzielone na wiele
linie. Przykład:

#REF #how_to_profile;(Uwaga: profilowanie);
(1) (2)

1. Odniesienie do znacznika HTML NAZWA w bieżącym dokumencie, pojedyncze słowo.
Może to być również pełny link URL.
Listę NAZW można uzyskać, włączając opcję --toc-url-print.

2. Klikalny tekst jest ograniczony przez ; postacie.

Odwoływanie się do dokumentów zewnętrznych.
Tagu „#URL” można użyć do osadzania adresów URL w tekście, tak aby pełny link nie był widoczny.
Tylko pokazany tekst służy do przechodzenia do adresu URL. Tej dyrektywy nie można złamać
oddzielne linie,

#URL
| |
| dozwolone są tutaj białe znaki
Muszą być trzymane razem

Jakby napisane:

Zobacz wyszukiwarkę #URLhttp://www.google.com>

STÓL JADALNIANY OF TREŚĆ NAGŁÓWEK

Jeśli istnieje nagłówek 1, który nazywa się dokładnie „Spis treści”, to cały tekst do
następny nagłówek są odrzucane z wygenerowanego pliku HTML. Dzieje się tak, ponieważ program
generuje własny spis treści. Przypuszcza się, że używasz jakiegoś programu do formatowania tekstu
generujesz dla siebie toc w pliku .txt i nie prowadzisz go ręcznie. Na przykład
Pakiet Emacsa tinytf.el może być użyty.

ROZWIĄZYWANIE PROBLEMÓW

generowane HTML dokument zrobił nie na temat co I zamierzony
Najczęstszym błędem jest umieszczanie w dokumencie dodatkowych znaków nowej linii. Zachowaj pierwszej pusty
zachowaj linię między nagłówkami a tekstem pierwszej pustą linię między akapitami, zachowaj pierwszej pusty
linia między tekstem podstawowym a punktorem. Uczyń z tego swoją mantrę: pierwszej pierwszej pierwszej ...

Następnie możesz umieścić tekst w niewłaściwej pozycji kolumny. Pamiętaj, że zwykły tekst jest o godz
kolumna 8.

Jeśli wygenerowany HTML nagle zacznie używać tylko jednej czcionki, np , to zapomniałeś
zamknąć blok. Spraw, by było czytane równo, w ten sposób:

Blok kodu
Blok kodu
Blok kodu
;; Dodaj tutaj pusty komentarz, aby „zamknąć” przykładowy kod w kolumnie 12

Nagłówki zaczynają się od dużej litery lub cyfry, na przykład „Nagłówek”, a nie „Nagłówek”. Podwójne sprawdzenie
pisownia.

PRZYKŁADY

Aby wydrukować stronę testową i pokazać wszystkie możliwości:

t2html --strona-testowa

Aby utworzyć prostą stronę HTML bez żadnych metainformacji:

t2html --title "Tytuł strony HTML" --author "Pan Foo"
--simple --out --drukuj plik.txt

Jeśli masz okresowe posty w formacie e-mail, użyj --usuń nagłówki e-maili ignorować nagłówek
tekst:

t2html --out --print --delete-email-headers page.txt

Aby strona była szybka

t2html --html-frame --out --print page.txt

Aby przekonwertować stronę z dokumentu tekstowego, w tym metatagi, przyciski, kolory i ramki. Płacić
uwaga na wyłącznik --html-ciało który definiuje język dokumentu.

t2html
--wydrukować
--na zewnątrz
--autor „Pan Foo”
--e-mail "foo@example.com"
--title "To jest strona podręcznika strony BAR"
--html-body LANG=pl
--button-prev poprzedni.html
--button-top indeks.html
--buttion-next next.html
--dokument http://example.com/dir/this-page.html
--url podręcznik.html
--kod-css-bg
--css-code-note '(?:Uwaga|Uwaga|Ostrzeżenie):'
--html-ramka
--plik-zastrzeżeń $HOME/txt/my-html-footer.txt
--meta-keywords "język-en,podręcznik,program"
--meta-description "Program barowy do robienia tego i innych"
manual.txt

Aby sprawdzić łącza i wydrukować stan wszystkich łączy na równi z komunikatem o błędzie http (most
gadatliwy):

t2html --link-check plik.txt | tee link-error.log

Aby wydrukować tylko problematyczne łącza:

t2html --link-check --quiet plik.txt | tee link-error.log

Aby wydrukować zwięzłe wyjście w sposób podobny do egep -n: numer linii, link i kod błędu:

t2html --link-check-single --quiet plik.txt | tee link-error.log

Aby sprawdzić linki z wielu stron i przechowywać dobre linki w oddzielnym pliku, użyj --pamięć-linków
opcja. Następne sprawdzanie łącza przebiegnie znacznie szybciej, ponieważ nie będzie prawidłowych łączy zapisanych w pamięci podręcznej
pobrane ponownie. W regularnych odstępach czasu usuwaj plik pamięci podręcznej łączy, aby wymusić pełne sprawdzenie.

t2html --link-check-single
--link-cache $HOME/tmp/link.cache
-- cichy plik.txt

Aby podzielić duży dokument na części i przekonwertować każdy z nich na HTML:

t2html --split1 --nazwa-podziału plik.txt | t2html --prosty --out

ŚRODOWISKO

E-MAIL
Jeśli zmienna środowiskowa E-MAIL jest zdefiniowana, jest używana w stopce adresu kontaktowego.
Option --e-mail zastępuje ustawienie środowiska.

JĘZYK
Domyślne ustawienie języka dla przełącznika „--language” Upewnij się, że pierwsze dwa
znaków zawiera definicję języka, na przykład: LANG=en.iso88591

Korzystaj z t2html online, korzystając z usług onworks.net