Chapter 2 Инструменти

Table of Contents
2.1 Задължителни инструменти
2.2 Опционални инструменти

FDP използва различни инструменти, за да се улесни работата с документацията на FreеBSD и преобразуването й в различни изходни формати. Ще е необходимо да използвате тези инструменти ако смятате да работите с документите.

Инструментите се намират в колекцията от програми за FreeBSD ports, това много улеснява работата по инсталирането им.

Трябва да инсталирате тези инструменти преди да започнете с работата по примерите в следващите глави. Как се използват тези инструменти е обяснено по-нататък.

Използвайте textproc/docproj ако е възможно: Можете да си спестите много време като инсталирате textproc/docproj порт. Това е meta-port, който не съдържа никакъв софтуер. Вместо това, предизвиква инсталирането на множество други портове (програми). Инсталирането на този порт, автоматично ще изтегли и инсталира всички описани в тази глава пакети, които ви трябват.

Един от пакетите, които са необходими, е JadeTeX макро набор. Този макро набор изисква да бъде инсталиран TeX. TeX е доста голям пакет и ще е необходим само ако ще изграждате Postscript или PDF като крайни документи.

За да си спестите време и място, когато инсталирате този порт, можете да изберете дали искате JadeTeX (и поради това и TeX) да бъдат инсталирани. Направете;

# make JADETEX=yes install
или
# make JADETEX=no install
ако е необходимо.

2.1 Задължителни инструменти

2.1.1 Софтуер

Тези програми са необходими преди да направите каквото и да било полезно с документацията за FreeBSD, те ще ви помогнат да я конвертирате към HTML, plain text и RTF формати. Всички те са включени в textproc/docproj.

SP ( textproc/sp)

Набор от приложения за валидизиране и нормализиране на SGML.

Jade ( textproc/jade)

DSSSL инструментариум. Използва се за конвертиране на маркирани вече документи към други формати, включително HTML и TeX.

Tidy ( www/tidy)

HTML 'красив принтер', използва се за преформатиране на някои от автоматично генерираните HTML документи, за да изглеждат по-четливо.

Links ( www/links)

Браузер за текстов режим, WWW браузер, който също може да конвертира HTML файлове към обикновен текст.

peps ( graphics/peps)

Част от документите съдържат графични файлове, някои от които са записани като EPS файлове. Те трябва да бъдат конвертирани към PNG преди повечето браузери да могат да ги покажат.

2.1.2 DTDs и Entities

Това са DTD и заглавни набори използвани от FDP. Те също трябва да бъдат инсталирани преди да можете да работите с документацията.

HTML DTD ( textproc/html)

HTML е езика за маркиране избран за World Wide Web и се използва в уеб сайта на FreeBSD.

DocBook DTD ( textproc/docbook)

DocBook е с дизайн за маркиране на техническа документация. Всички FreeBSD документи са написани в DocBook.

ISO 8879 заглавия ( textproc/iso8879)

19 от ISO 8879:1986 символни заглавни набори използвани от много DTD. Включват математически символи, допълнителни символи към латинския символен набор (акцентни, диакритични и т.н.) и гръцки символи.

2.1.3 Stylesheets (стилови таблици)

Стиловите таблици се използват при конвертиране и форматиране на документи за показване върху екран, отпечатване и т.н.

Модулни DocBook стилови таблици ( textproc/dsssl-docbook-modular)

Модулните DocBook стилови таблици се използват при конвертиране на документи маркирани в DocBook към други формати, като HTML или RTF.

Този и други документи можете да намерите в ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

За въпроси отностно FreeBSD, прочетете документацията преди да попитате в <questions@FreeBSD.org>.
За въпроси отностно този документ, e-mail <doc@FreeBSD.org>.