- Index.html Policy
- Требования к indexhtml-пакетам
- Именование пакетов
- Каталог установки
- Именование html-файлов
- Конфликты
- Расположение в меню
- Использование пакета indexhtml-common
- Как просмотреть документацию для установленной библиотеки?
- 2 ответа
- Поиск документации по Ubuntu
- 1. Поиск с использованием наутилуса или браузера
- 2. Используя команду find
- 3. Составьте список, ищите и вызывайте с меньшими затратами.
- 4. Пакетное решение APT
- Как просмотреть документацию для установленной библиотеки?
- 2 ответа
- Нахождение Документации относительно человечности
- 1. Поиск с помощью наутилуса или браузера
- 2. Используя команду находки
- 3. Составьте список и ищите и вызовите с меньше
- 4. Решение для пакета APT
- File usr share doc html index htm
Index.html Policy
Так же стартовая страница, может содержать ссылки на группы обсуждени в социальных сетях.
Стартовая страница дистрибутива может быть переведена на несколько языков. В этом случае крайне желательно размещать на странице ссылки на другие языковые варианты.
Требования к indexhtml-пакетам
Именование пакетов
Пакеты следует именовать по следующей схеме: branding-название_дистрибутива>-indexhtml
Группа для указания в spec-файле: System/Base
Name: branding-simply-linux-indexhtml Group: System/Base
Каталог установки
Файлы indexhtml-пакета (html, стили, логотипы и т. п.) устанавливаются в каталог /usr/share/doc/indexhtml/
(? Совместимость со старым месторасположением index.html файла (/usr/share/doc/HTML/index.html) на переходный период обеспечивается indexhtml-common пакетом.)
Именование html-файлов
html-файлы именуются по следующей схеме: index-$lang.html, где $lang — друзначный языковой код (en, ru, uk, be, de и тп.). По крайней мере index-en.html файл обязан присутсвовать в пакете, так как именно он будет использован по умолчанию в случае ненахождения подходящего index-$lang.html файла.
Конфликты
Так как indexhtml-пакеты устанавливают свои файлы в один и тот же каталог, а также по причине того, что indexhtml-пакет дистрибутивоспецифичен, в системе не должно одновременно присутствовать более одного indexhtml-пакета. Для обеспечения этого пакеты должны иметь конфликты на каждый branding-distro-indexhtml пакет, то есть содержать в своём spec-файле:
Provides: indexhtml Cоnflicts: branding-firstdistro-indexhtml, branding-seconddistro-indexhtml, branding-thirddistro-indexhtml
Расположение в меню
indexhtml-пакеты должны содержать desktop-файл для интеграции в меню. При этом в desktop-файле указывается:
. Categories=System;Documentation; .
Использование пакета indexhtml-common
Скрипт indexhtml-update, входящий в состав пакета indexhtml-common, создаёт ссылку (index.html) на нужный языковой вариант приветственной страницы и должен использоваться в %post-секциях spec-файла. Важно помнить, что именно index.html файл является файлом, открываемым по умолчанию браузерами. Поэтому наличие этого файла является обязательным.
Пример использования indexhtml-update в spec-файле:
. %files %ghost %_indexhtmldir/index.html . %post %_sbindir/indexhtml-update .
Как просмотреть документацию для установленной библиотеки?
Я установил doxygen а также doxygen-doc , Страница man для doxygen говорит мне получить doxygen-doc для получения дополнительной информации. Я нашел doxygen-doc в моем usr/share/doc , но это сжатый архив. Так как я могу получить к нему удобный доступ?
2 ответа
Вы не указываете версию Ubuntu, которую используете, но для Trusty есть руководство в формате PDF на /usr/share/doc/doxygen/doxygen_manual.pdf ,
Здесь также есть HTML документация: /usr/share/doc/doxygen/html/index.html
Я не могу найти сжатый архив, кроме журнала изменений ( /usr/share/doc/doxygen-doc/changelog.Debian.gz ) что вы посмотрите на использование zless ,
Поиск документации по Ubuntu
1. Поиск с использованием наутилуса или браузера
Вы можете искать, как указано выше, в каталоге / usr / share / doc, но некоторые пакеты устанавливают его в свои каталоги / usr / share / package_name или даже в другие места. Здесь вы можете найти html и pdf docus, лучше всего использовать nautilus (используйте функцию поиска nautilus и откройте запрошенный вами документ в вашем браузере). Если вы часто используете документ, не забудьте добавить в закладки вашу ссылку.
2. Используя команду find
Из командной строки вы можете использовать команду find для поиска вашего документа:
- HTML-документы: find /usr/share -type f -name index.html | grep doxy
- PDF-справка о: find /usr/share/ -type f -name *.pdf | grep doxy
Вызвать свой результат с помощью evince или браузера (в моем случае google-chrome)
- HTML: google-chrome /usr/share/doc/doxygen/html/index.html
- PDF: google-chrome /usr/share/doc/doxygen_manual.pdf evince /usr/share/doc/doxygen_manual.pdf
3. Составьте список, ищите и вызывайте с меньшими затратами.
Я предпочитаю автоматизировать эту задачу и составить список следующим образом:
- для HTML: find /usr/share/ -type f -name index.html | sort -k1 | awk ‘< print "file://" $0;>‘ > ~/DocHtml.txt
- для PDF: find /usr/share/ -type f -name *.pdf | sort -k1 | awk ‘< print "file://" $0;>‘ > ~/DocPdf.txt
Это создаст 2 файла в вашем домашнем каталоге (DocPdf.txt и DocHtml.txt). Просто откройте это с меньшими затратами
и нажмите &, затем введите строку поиска, например, doxygen. Теперь просто наведите курсор мыши на требуемый документ и нажмите Ctrl, и щелчок левой кнопкой мыши откроет файл.
Вы также можете создать скрипт bash и вызывать его через задание chron. Это автоматизирует задачу.
Вот простой скрипт bash, который можно изменить. Поместите дополнительные каталоги, как описано в скрипте. Сохраните приведенный ниже скрипт bash как makeDoc, измените chmod +x makeDoc и вызовите его с помощью ./makeDoc. Отдых, как указано выше:
#!/bin/bash # Author: abu # Description: script creates two files, DocPdf.txt and DocHtml.txt, # which lists all pdf/html documents found by the find function. # # You can include other search directories, e.g. Anaconda, declare -a DocDirs=( "/usr/share/" "/opt/anaconda3/" # you can put here additional directories # "/path/to/other/dirs/" # -""- -""- -""- ) echo "DocHtml automatic generated!" > DocHtml.txt echo " File generated with" $0 >> DocHtml.txt echo -e " Date: " `date` "\n\n" >> DocHtml.txt echo "DocPdf automatic generated!" > DocPdf.txt echo " File generated with" $0 >> DocPdf.txt echo -e " Date: " `date` "\n\n" >> DocPdf.txt for i in "$" do find $i -type f -name index.html | sort -k1 | awk '< print "file://" $0;>' >> ~/DocHtml.txt find $i -type f -name *.pdf | sort -k1 | awk '< print "file://" $0;>' >> ~/DocPdf.txt done
4. Пакетное решение APT
Пакет doc-base помогает разработчикам правильно его установить. Для просмотра я знаю dhelp и doc-central.
4.1 dhelp: читатель документации веб-базы.
sudo apt-get install dhelp
и откройте в вашем браузере файл:
file:///usr/share/doc/HTML/Programming/Awk/index.html
- документация хорошо проиндексирована
- документация доступна через веб-браузер
- Документация по индексам (в фоновом режиме)
- Не очень удобный интерфейс командной строки.
4.2 doc-central: читатель документации веб-базы.
sudo apt-get install doc-central
- документация хорошо проиндексирована
- документация доступна через веб-браузер
- Документация по индексам (в фоновом режиме)
- не очень удобный интерфейс командной строки
Как просмотреть документацию для установленной библиотеки?
Я установил doxygen и doxygen-doc . Страница справочника для doxygen говорит мне получать doxygen-документ для получения дополнительной информации. Я нашел doxygen-doc в моем usr/share/doc , но это — сжатый архив. Таким образом, как я могу получить доступ к нему удобно?
2 ответа
Вы не заявляете версию Ubuntu, который Вы используете, но для Надежного человека, существует руководство PDF в /usr/share/doc/doxygen/doxygen_manual.pdf .
здесь существует также документация HTML: /usr/share/doc/doxygen/html/index.html
я не могу разыскать сжатый архив помимо журнала изменений ( /usr/share/doc/doxygen-doc/changelog.Debian.gz ), что Вы посмотрели бы на использование zless .
Нахождение Документации относительно человечности
1. Поиск с помощью наутилуса или браузера
Можно искать, как упомянуто выше в/usr/share/doc каталоге, но некоторые пакеты устанавливают его в своих/usr/share/package_name каталогах или даже других местоположениях. Здесь можно найти HTML и PDF docus, лучше всего с помощью наутилуса (используйте поисковую функцию наутилуса и откройте требуемый docu в браузере). Если Вы часто используете docu, не забывают отмечать Вашу ссылку.
2. Используя команду находки
Из Вашей командной строки можно использовать команду находки для поиска docu:
- документация HTML: find /usr/share -type f -name index.html | grep doxy
- pdf-documention: find /usr/share/ -type f -name *.pdf | grep doxy
Вызовите свой результат с, проявляют или Ваш браузер (в моем случае Google Chrome)
- HTML: google-chrome /usr/share/doc/doxygen/html/index.html
- PDF: google-chrome /usr/share/doc/doxygen_manual.pdf evince /usr/share/doc/doxygen_manual.pdf
3. Составьте список и ищите и вызовите с меньше
Я предпочитаю автоматизировать эту задачу и входить в список следующий путь:
- для HTML: find /usr/share/ -type f -name index.html | sort -k1 | awk ‘< print "file://" $0;>‘ > ~/DocHtml.txt
- для PDF: find /usr/share/ -type f -name *.pdf | sort -k1 | awk ‘< print "file://" $0;>‘ > ~/DocPdf.txt
Это создаст 2 файла в Вашем корневом каталоге (DocPdf.txt и DocHtml.txt). Просто откройте это с меньше
и нажмите и сопровождаемый с Вашей строкой поиска, например, doxygen. Теперь простое перемещение Ваша мышь по требуемому документу и нажатию ctrl и нажатию левой кнопки мышки откроет файл.
Можно также сделать сценарий удара и вызвать его через chron задание. Это автоматизирует задачу.
Вот простой сценарий удара, который может быть изменен. Поместите дополнительные каталоги, как описано в сценарий. Сохраните ниже сценария удара как makeDoc, chmod +x makeDoc изменения и вызовите его с./makeDoc. Отдых как выше:
#!/bin/bash # Author: abu # Description: script creates two files, DocPdf.txt and DocHtml.txt, # which lists all pdf/html documents found by the find function. # # You can include other search directories, e.g. Anaconda, declare -a DocDirs=( "/usr/share/" "/opt/anaconda3/" # you can put here additional directories # "/path/to/other/dirs/" # -""- -""- -""- ) echo "DocHtml automatic generated!" > DocHtml.txt echo " File generated with" $0 >> DocHtml.txt echo -e " Date: " `date` "\n\n" >> DocHtml.txt echo "DocPdf automatic generated!" > DocPdf.txt echo " File generated with" $0 >> DocPdf.txt echo -e " Date: " `date` "\n\n" >> DocPdf.txt for i in "$" do find $i -type f -name index.html | sort -k1 | awk '< print "file://" $0;>' >> ~/DocHtml.txt find $i -type f -name *.pdf | sort -k1 | awk '< print "file://" $0;>' >> ~/DocPdf.txt done
4. Решение для пакета APT
Основа документа пакета помогает разработчикам установить его корректным способом. Для просмотра этого, я знаю dhelp и центральный документом.
4.1 dhelp: веб-основной читатель документации.
sudo apt-get install dhelp
и откройте в своем браузере файл:
file:///usr/share/doc/HTML/Programming/Awk/index.html
- документация хорошо индексируется
- документация доступна через веб-браузер
- индексная документация (в фоновом режиме)
- не так удобный интерфейс командной строки.
4,2 центральных документом: веб-основной читатель документации.
sudo apt-get install doc-central
- документация хорошо индексируется
- документация доступна через веб-браузер
- индексная документация (в фоновом режиме)
- не так удобный интерфейс командной строки
File usr share doc html index htm
После загрузки системы будет показано приглашение к входу в систему. Для входа используйте персональный логин и пароль, которые вы указали во время процесса установки. Система готова к работе.
Если вы новичок, то начните с просмотра документации, которая уже установлена в системе. Есть несколько систем документации, продолжается работа над их объединением. Вот несколько мест, откуда можно начать.
Документация на установленные программы находится в /usr/share/doc/ в подкаталоге с именем этой программы. (точнее, с именем пакета Debian, в котором содержится эта программа). Однако более полная документация часто упакована отдельно в специальные пакеты с документацией, которые по умолчанию не устанавливаются. Например, документацию на программу управления пакетами apt можно найти в пакетах apt-doc или apt-howto .
Также, /usr/share/doc/ содержит несколько специальных каталогов. Linux HOWTO установлены в формате .gz в каталог /usr/share/doc/HOWTO/en-txt/ . После установки dhelp появляется файл /usr/share/doc/HTML/index.html со ссылками на документацию.
Простой способ просмотреть эту документацию — запустить текстовый браузер с помощью команд:
Точка после команды w3c служит для показа содержимого текущего каталога.
Если у вас установлено графическое окружение рабочего стола, то также вы можете использовать веб-браузер. Запустите веб-браузер из меню приложений и введите /usr/share/doc/ в строке адреса.
Также вы можете набрать info команда или man команда , чтобы получить документацию по большинству команд доступных в командной строке. Набрав help , вы увидите помощь по командам интерпретатора командной строки. А при вводе имени команды с параметром —help обычно выдаётся короткая справка по использованию программы. Если начало результата выполнения команды уехало за пределы экрана, добавьте | more после команды, и это включит паузу при заполнении всего экрана. Чтобы увидеть список всех доступных команд, начинающихся с определённого символа, введите символ и нажмите клавишу табуляции два раза.