Người dùng thông thường sẽ đọc tài liệu trong / usr / share / doc như thế nào?

Gần đây tôi đã biết rằng có một đống tài liệu khổng lồ /usr/share/doc.

Có vẻ như phần lớn được nén, do đó nó không thể truy cập trực tiếp mà không có đặc quyền quản trị:

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

Mặc dù một giải pháp cho vấn đề này là mọi người dùng sẽ sao chép từng mục trong thư mục chính của họ chỉ để đọc nó, nhưng sự sắp xếp này dường như không có lợi cho việc duyệt web thông thường.

Làm thế nào để người bình thường đọc tài liệu này?

Tôi không có xu hướng tin rằng người dùng thông thường dự kiến ​​sẽ cài đặt và duy trì một máy chủ web chỉ để đọc tài liệu văn bản địa phương.

Hầu hết đã được nói và giải thích rất độc đáo bởi jgbelacqua để sử dụng trong thiết bị đầu cuối. Chỉ cần thêm phần này cho những người ở trên trình quản lý máy tính để bàn:

Từ máy tính để bàn đồ họa (ở đây là Gnome) cách dễ nhất để đọc tài liệu /usr/share/doclà (nhấp chuột đôi) mở tệp được nén bằng trình quản lý lưu trữ tiêu chuẩn của bạn (ở đây Con lăn tệp) từ đó bạn có thể (nhấp hai lần) mở và đọc chúng trong trình soạn thảo tiêu chuẩn của bạn (ở đây là Gedit). Không có quyền ghi cần thiết miễn là bạn không giải nén các tệp.

Có ít nhất hai vấn đề ở đây:

1. đọc các tập tin .gz không đau
2. quyền trên thư mục
3. (tùy chọn cho các tập tin tex)

Đối với # 1 , có một số ứng dụng sẽ đối phó với các tệp được nén một cách liền mạch. Một cặp vợ chồng mà bạn có thể sử dụng là lessvà vim.

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

viewlà một bí danh cho vim -R, chỉ nói để mở tệp chỉ đọc.

Vào thời xưa, trước khi cài đặt ít hơn trên hệ thống của tôi, tôi sẽ sử dụng gzcatvà chuyển đầu ra sang một tiện ích khác. Rõ ràng, hiện tại nó chỉ được gọi zcattrên Ubuntu, nhưng bạn sẽ sử dụng nó như thế này, vd:

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

zcat vẫn có sẵn và sử dụng nó để dẫn nội dung nén ở đâu đó có thể hữu ích trong một số trường hợp. (Đối với các tình huống có tệp .bz2, bzcatkhả dụng.)

Đối với # 2 , tất cả các tệp mà tôi đã xem trong / usr / share / doc đều nằm trong các thư mục có quyền + rx khác, nghĩa là tất cả người dùng có thể tìm kiếm các thư mục (ví dụ: liệt kê nội dung) và đọc các tệp bên trong. Những gì bạn không thể làm (vì chỉ có quyền root mới có quyền ghi), là tạo tệp. Bởi vì bạn đang cố giải nén vào thư mục đó, tôi tưởng tượng nó đang cho phép bạn bị từ chối vì bạn đã đọc nhưng không viết quyền theo mặc định.

Đối với # 3, tôi đoán bạn sử dụng các tệp .tex nhiều hơn tôi. Nhưng đây là một cách để đối phó với chúng mà không cần sao chép vào nhà hoặc tệp tạm thời. Đối với điều này, bạn sẽ tạo ra một đường ống có tên, nhưng bạn có thể sử dụng lại cho các nhu cầu xử lý và đường ống tex khác của bạn. Nó nên đi như thế này:

• zcat hoặc gzcat văn bản
• ... Và chuyển nó đến bộ xử lý TeX của bạn
• ... và gửi nó đến ống tên của bạn (ở đây, tôi sẽ gọi cho anh ấy pipey)
• ... và sau đó trong một màn hình riêng biệt lấy đầu ra của bạn từ pipey
• ... và gửi nó đến một quy trình hiển thị dvi.

Rõ ràng bạn có thể thay đổi các bước này nếu bạn sử dụng các tiện ích khác hoặc tốt hơn các tiện ích ở đây.

Ví dụ của tôi sẽ sử dụng mkfifotiện ích để tạo đường ống có tên , pipey. Các tập tin mục tiêu để xử lý là /usr/share/doc/gdb/refcard.tex.gz. Bạn sẽ cần hai dòng lệnh shell có sẵn (thông qua thiết bị đầu cuối, Alt + F2 hoặc tuy nhiên).

Bạn sẽ nhập vào thiết bị đầu cuối một:

mkfifo pipey

Bây giờ bạn có một ống tên là dai dẳng. Bạn có thể sử dụng ls -lđể nhìn trộm nó.

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

Lưu ý rằng lệnh này sẽ không quay trở lại cho đến khi bạn làm điều gì đó với đầu ra đi đến đường ống được đặt tên.

Bây giờ, trong thiết bị đầu cuối hai, bạn sẽ gõ: tex pipey | xdvi

Và nó hoạt động (tốt, dù sao ở đây). Quá trình có thể được tinh chỉnh cho đầu ra đẹp hơn, nhưng nếu bạn đang tìm kiếm nhanh chóng và tương đối không lộn xộn, đó là một cách để làm điều đó.

Có lẽ đó là quá muộn để trả lời, nhưng tôi đã tìm thấy giải pháp tốt nhất (cả dễ sử dụng và đầy đủ)

• Cài đặt dwww

Một hệ thống Linux điển hình có tài liệu ở nhiều định dạng (trang thủ công, tệp Thông tin, README, v.v.). dwww cho phép truy cập tất cả những thứ này thông qua cùng một giao diện, một trình duyệt WWW. Điều này làm cho nó dễ dàng hơn để sử dụng các tài liệu.

dwww là giao diện web cho tất cả tài liệu trực tuyến trên hệ thống Debian. Nó xây dựng một số trang web liệt kê tất cả các tài liệu đã cài đặt và chuyển đổi tất cả các tài liệu thành HTML. Việc chuyển đổi được thực hiện khi người dùng yêu cầu tài liệu.

• Kích hoạt mô-đun CGI, không còn được bật theo mặc định trong Ubuntu / Apache gần đây:

  sudo a2enmod cgi
  sudo service apache2 restart
  

• Mở trình duyệt của bạn và trỏ đến: http: // localhost / dwww /

• Làm xong!

Tất cả các infotrang, mantrang, /usr/share/doctệp và mô tả gói của bạn ở một nơi duy nhất! Trang web tài liệu cá nhân của bạn!

gunzip file.gznỗ lực để giải nén file.gzđể file, loại bỏ file.gz. Đó là lý do tại sao bạn gặp lỗi "Quyền bị từ chối", bạn không được phép viết vào /usr/share/doc. Để có được nội dung của một tập tin, sử dụng gunzip -c file.gzhoặc zcat file.gz.

Đọc các tệp văn bản được nén bằng gzip có thể được thực hiện với zless. Như tên của nó có thể gợi ý, nó chỉ là less, nhưng đối với các tệp được nén bằng gzip.

Ví dụ sử dụng:

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

Các .gzhậu tố có thể được bỏ qua cũng như:

zless /usr/share/doc/bash/NEWS

Đầu tiên cài đặt apache2

sudo apt-get install apache2 apache2-doc  

apache2-doclà trường hợp đặc biệt ở đây. Nó cho phép bạn duyệt tài liệu /usr/share/doc/của bạn thông qua trình duyệt web của bạn. fro http://localhost/doc/.

Điều này không làm việc đúng mặc dù. Bạn cần thay đổi cấu hình của Apache để giải nén nó và hiển thị các tệp * .gz dưới dạng văn bản thuần túy.

Tôi đã đăng lên Stack Overflow để có cách sử dụng Apache để hiển thị nội dung của các tài liệu * .gz trong /usr/share/doc/thư mục. Đây là những gì đã được đăng là giải pháp có thể.

Dưới đây là những hướng dẫn ngắn gọn. Nó cho Apache biết cách xử lý các tệp .gz để xử lý chúng dưới dạng văn bản thuần túy và gửi chúng đến trình duyệt dưới dạng văn bản thuần túy.

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

Đi đến dưới cùng của tập tin và tìm phần với Alias /doc/ "/usr/share/doc/" và thay đổi nó để trông như thế này.

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>   

Sau đó khởi động lại Apache:

sudo apache2ctl restart   

Bạn không nên đọc các tập tin .tex! Nó ở định dạng có thể đọc được, nhưng nó được thiết kế để được xử lý trước khi tăng dần. Bạn có thể sử dụng công cụ tex2pdf để chuyển đổi nó thành .pdf.