File05 usr share doc html index html

Как обычные пользователи могут читать документацию в / usr / share / doc?

Недавно я узнал, что есть огромная куча документации /usr/share/doc .

Похоже, что большая часть этого gzip-файла, так что он не доступен напрямую без прав администратора:

$ gunzip examples/letter.tex.gz gzip: examples/letter.tex: Permission denied 

В то время как одно решение для этого было бы для каждого пользователя дублировать каждый элемент в их домашнем каталоге только для того, чтобы прочитать его, эта договоренность вряд ли способствует регулярному просмотру.

Как нормальные люди читают эту документацию?

Я не склонен полагать, что обычный пользователь должен устанавливать и поддерживать веб-сервер только для чтения локальной текстовой документации.

Просто чтобы прояснить, вы заинтересованы в работе с какими-либо документами в каталогах / usr / share / doc или только с TeX / LaTeX?

Хорошо, еще один вопрос — вам нужно обработать файлы .tex в dvi или что-то еще, или просто посмотреть на исходный код?

Я спрашиваю о документации в /usr/share/doc целом и с особым вниманием к наблюдению, что большая часть ее хранится в сжатом формате. Если есть какая-либо документация, хранящаяся как не набранный LaTeX, мне еще предстоит с этим столкнуться. Конкретный пример, на который я ссылался выше, это шаблон LaTeX из пакета texlive-latex-extra-doc .

askubuntu.com/questions/24072/… . Я думаю, что это лучшее решение из всех одной установки, и оно работает там после.

Большинство из них было сказано и очень хорошо объяснено jgbelacqua для использования в терминале. Просто добавьте это для людей, которые находятся на рабочем столе менеджера:

С графического рабочего стола (здесь GNOME) самый простой способ читать документы /usr/share/doc — это (дважды) щелкнуть по заархивированным файлам с помощью стандартного менеджера архивов (здесь File Roller), откуда вы можете (дважды) щелкнуть по кнопке open и прочитать их в ваш стандартный редактор (здесь Gedit). Разрешения на запись не требуются, если вы не разархивируете файлы.

Прекрасное решение. Именно поэтому люди используют такие вещи, как Ubuntu, Gnome и т. Д. Такая задача упрощается.

Здесь есть как минимум две проблемы:

1. чтение файлов .gz безболезненно
2. разрешения на каталоги
3. (необязательно для текстовых файлов)

Для # 1 есть ряд приложений, которые легко справятся с файлами gzip. Пара, которую вы могли бы использовать, less и vim .

 less README.gz vim -R README.Debian.gz view Important.bits.gz 

view это псевдоним для vim -R , который просто говорит, чтобы открыть файл только для чтения.

В старые времена, до того, как на моей системе было установлено less, я использовал gzcat и направлял вывод в другую утилиту. По-видимому, zcat теперь он вызывается только в Ubuntu, но вы бы использовали его так, например:

 /usr/share/doc/xpdf$ zcat changelog.Debian.gz | more 

zcat по-прежнему доступен, и его использование для передачи сжатого содержимого куда-то может быть полезно в некоторых случаях. (Для ситуаций с файлами .bz2, bzcat доступно.)

Для # 2 все файлы, которые я видел в / usr / share / doc, находятся в каталогах с другими разрешениями + rx, что означает, что все пользователи могут искать каталоги (например, содержимое списка) и читать файлы внутри. Что вы не можете сделать (так как только root имеет разрешение на запись по умолчанию), это создавать файлы. Поскольку вы пытаетесь разархивировать в этот каталог, я полагаю, что он дает вам отказано в разрешении, потому что у вас есть права на чтение, но не на запись по умолчанию.

Для # 3, я предполагаю, что вы используете файлы .tex больше, чем я. Но вот один из способов справиться с ними без копирования в домашний или временный файл. Для этого вы собираетесь создать именованный канал, но вы можете использовать его для других своих нужд, связанных с передачей и обработкой текстовых сообщений. Это должно идти так:

• zcat или gzcat текст
• . и передать это на ваш процессор TeX
• . и отправь это на твой Named Pipe (здесь я позвоню ему pipey )
• . а затем на отдельном экране захватить ваш вывод из pipey
• . и отправить это в процесс отображения DVI.

Очевидно, вы можете изменить эти шаги, если вы используете другие или лучшие утилиты, чем те, что здесь.

Мой пример будет использовать mkfifo утилиту для создания именованного канала pipey . Целевой файл для обработки /usr/share/doc/gdb/refcard.tex.gz . Вам понадобятся две доступные командные строки оболочки (через терминал, Alt + F2 или другие).

Вы напечатаете в терминале один:

Теперь у вас есть постоянный именованный канал. Вы можете использовать, ls -l чтобы посмотреть на это.

zcat /usr/share/doc/gdb/refcard.tex.gz | tex > pipey

Обратите внимание, что эта команда не вернется, пока вы не сделаете что-то с выводом, который ушел в именованный канал.

Теперь во втором терминале вы наберете: tex pipey | xdvi

И это работает (ну, в любом случае, здесь). Процесс может быть улучшен для более приятного вывода, но если вы ищете быстрый и относительно беспроблемный, это один из способов сделать это.

Источник

Как просмотреть документацию для установленной библиотеки?

Я установил 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 

• документация хорошо проиндексирована
• документация доступна через веб-браузер
• Документация по индексам (в фоновом режиме)
• не очень удобный интерфейс командной строки

Источник