logo
Литература_1 / photon_old

Файлы таблиц содержания

Файлы таблиц содержания (Table-of-contents-TOC) определяют список продуктов, имеющих информационную помощь, и иерархию тем для каждого продукта. Эти файлы имеют расширение .toc. Все они располагаются в директории /usr/help/product. Каждый продукт имеет TOC-файл 1-го уровня и директорию с чем-либо ещё. Так, например, помощь по Photon'у включает:

photon.toc

photon/

Файл photon.toc состоит из следующей строки:

1 | Photon micro GUI | ./photon/bookset.html

где:

1 – это уровень иерархии тем;

| – разделитель областей;

Photon micro GUI – название темы.

./photon/bookset.html – унифицированный указатель информационного ресурса (URL) комплекта описания.

 Не используйте вертикальную черту ( | ) в названии темы, поскольку она используется в TOC-файлах в качестве разделителя.

Директория photon содержит TOC-файл и директорию для каждой книги. Например, она включает:

prog_guide.toc

prog_guide/

Файл prog_guide.toc похож на файл photon.toc:

2 | Programmer's Guide | ./prog_guide/about.html

Директория prog_guide содержит HTML-файлы и файл book.toc, который определяет названия тем в HTML-файлах:

3 | About This Guide | about.html#ABOUTTHISGUIDE

4 | Assumptions | #id3

4 | Chades and corrections | #ChangesAndCorrections

3 | Introduction | intro.html#id1

4 | Photon Application Builder – PhAB | #PhABApplications

6 | Get immediate results | #id3

.....

Часть URL, следующая за # – это анкер, определённый в HTML.

    1. Yandex.RTB R-A-252273-3
      Yandex.RTB R-A-252273-4