一般的なユーザーは、/ usr / share / docのドキュメントをどのように読むことが期待されますか？

私は最近、ドキュメンテーションの巨大な山があることを学びました/usr/share/doc。

その多くはgzip圧縮されているため、管理者権限なしでは直接アクセスできません。

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

これに対する解決策の1つは、すべてのユーザーがホームディレクトリ内の各アイテムを複製してそれを読み取ることですが、この配置は通常のブラウジングにはほとんど役に立たないようです。

通常の人はこのドキュメントをどのように読みますか？

一般的なユーザーがローカルのテキストドキュメントを読むためだけにWebサーバーをインストールして保守することを期待しているとは思わないでしょう。

ほとんどはjgbelacquaによってターミナルで使用されると言われ、非常にうまく説明されています。デスクトップマネージャーを使用しているユーザー向けにこれを追加するだけです。

グラフィカルデスクトップ（ここではGNOME）から文書を読む最も簡単な方法/usr/share/docは、（ダブル）クリックして、標準のアーカイブマネージャー（ここではファイルローラー）でzipファイルを開くことです。標準エディター（ここではGedit）。ファイルを解凍しない限り、書き込み権限は不要です。

ここには少なくとも2つの問題があります。

1. .gzファイルを簡単に読み取る
2. ディレクトリの権限
3. （Texファイルのオプション）

以下のために＃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は引き続き利用できます。zcatを使用して、圧縮されたコンテンツをどこかにパイプで送ると便利な場合があります。（.bz2ファイルbzcatを使用する場合に使用可能です。）

以下のために＃2、私はは、/ usr / share / docの下で見てきたことのすべてのファイルは、すべてのユーザーがディレクトリを（例えば、リストの内容）を検索し、内部のファイルを読むことができることを意味し、他の+ RX権限を持つディレクトリにあります。できないのは（デフォルトではrootのみが書き込み許可を持っているため）、ファイルを作成することです。あなたはそのディレクトリに解凍しようとしているので、デフォルトでは読み取り権限は持っているが書き込み権限は持っていないので拒否された権限を与えていると思います。

＃3については、私よりも.texファイルを使用していると思います。しかし、ここでは、ホームまたは一時ファイルにコピーせずにそれらに対処する1つの方法を示します。このために、名前付きパイプを作成しますが、それを他のtexパイピングおよび処理のニーズに再利用できます。次のようになります。

• テキストをzcatまたはgzcat
• ...そして、それをTeXプロセッサにパイプします
• ...それを名前付きパイプに送信します（ここでは、彼に電話しますpipey）
• ...そして、別の画面でpipeyから出力を取得します
• ...それをdvi表示プロセスに送信します。

ここにあるものとは異なる、またはより良いユーティリティを使用する場合、これらの手順を明らかに変更できます。

私の例では、mkfifoユーティリティを使用して名前付きパイプを作成しますpipey。処理するターゲットファイルは/usr/share/doc/gdb/refcard.tex.gzです。2つのシェルコマンドラインを利用できる必要があります（ただし、ターミナル、Alt + F2、または経由）。

ターミナル1を入力します。

mkfifo pipey

これで永続的な名前付きパイプができました。あなたはls -lそれを覗くのに使うことができます。

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

このコマンドは、名前付きパイプに送られた出力で何かをするまで戻りません。

次に、ターミナル2で次のように入力します。 tex pipey | xdvi

そして、それは動作します（まあ、とにかくここで）。プロセスはよりきれいな出力に向けて改良できますが、迅速で比較的混乱のないものを探しているなら、それはそれを行う1つの方法です。

答えるには手遅れかもしれませんが、最良の解決策を見つけました（使いやすさと完全性の両方）

• dwwwをインストールする

典型的なLinuxシステムには、多くの形式（マニュアルページ、Infoファイル、READMEなど）のドキュメントがあります。dwwwは、同じインターフェースであるWWWブラウザを介してこれらすべてにアクセスすることを可能にします。これにより、ドキュメントを使いやすくなります。

dwwwは、Debianシステム上のすべてのオンラインドキュメントへのWebインターフェイスです。インストールされているすべてのドキュメントをリストするWebページを作成し、すべてのドキュメントをHTMLに変換します。ユーザーがドキュメントを要求すると、変換が行われます。

• CGIモジュールを有効にします。これは、最近のUbuntu / Apacheではデフォルトで無効になっています。

  sudo a2enmod cgi
  sudo service apache2 restart
  

• ブラウザを開いて、http：// localhost / dwww /をポイントします

• できた！

すべてのinfoページ、manページ、/usr/share/docファイル、パッケージの説明を1か所で！あなたの個人的なドキュメントのウェブサイト！

gunzip file.gzへの圧縮解除file.gzを試みfile、削除しfile.gzます。そのため、「Permission denied」エラーが表示され、書き込みを許可されていません/usr/share/doc。ファイルの内容を取得するには、gunzip -c file.gzまたはを使用しますzcat file.gz。

gzipで圧縮されたテキストファイルの読み取りは、を使用して実行できますzless。名前が示すように、lessgzipで圧縮されたファイルの場合は、単なるになります。

使用例：

zless /usr/share/doc/bash/NEWS.gz

.gz接尾辞は、同様に省略することができます。

zless /usr/share/doc/bash/NEWS

最初にapache2をインストールする

sudo apt-get install apache2 apache2-doc  

apache2-docここが特別なケースです。/usr/share/doc/Webブラウザを使用してドキュメントを参照できます。あちこちhttp://localhost/doc/。

ただし、これは正しく機能しません。Apacheの構成を変更して、*。gzファイルを圧縮解除してプレーンテキストとして表示できるようにする必要があります。

Stack Overflowに投稿して、Apacheを使用して/usr/share/doc/ディレクトリ内の* .gzドキュメントのコンテンツを表示する方法を取得しました。これは、可能な解決策として投稿されたものです。

これらの手順を簡単に説明します。Apacheに.gzファイルを処理してプレーンテキストとして処理し、プレーンテキストとしてブラウザに送信する方法を指示します。

sudo a2enmod headers   
sudo a2enmod deflate  
gksu gedit /etc/apache2/sites-enabled/000-default 

ファイルの一番下に移動してセクションを見つけ、次のAlias /doc/ "/usr/share/doc/" ように変更します。

Alias /doc/ "/usr/share/doc/"
<Directory /usr/share/doc>
    Options Indexes MultiViews FollowSymLinks
    AllowOverride None
    Order deny,allow
    Deny from all
    Allow from 127.0.0.0/255.0.0.0 ::1/128

    AddEncoding gzip gz
    <FilesMatch "\.gz$">
      ForceType text/plain
      Header set Content-Encoding: gzip
    </FilesMatch>
</Directory>   

次に、Apacheを再起動します。

sudo apache2ctl restart   

.texファイルを読み取らないでください！人間が読める形式ですが、再配置する前に処理されるように設計されています。tex2pdfツールを使用して、.pdfに変換できます。