ผู้ใช้ทั่วไปคาดหวังว่าจะอ่านเอกสารใน / usr / share / doc อย่างไร

ฉันเพิ่งเรียนรู้ว่ามีกองเอกสารขนาดใหญ่/usr/share/docมา

ดูเหมือนว่าส่วนใหญ่จะเป็น gzipped ดังนั้นจึงไม่สามารถเข้าถึงได้โดยตรงโดยไม่มีสิทธิ์ระดับผู้ดูแลระบบ:

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

ในขณะที่วิธีการหนึ่งในการแก้ปัญหานี้สำหรับผู้ใช้ทุกคนในการทำซ้ำแต่ละรายการในโฮมไดเร็กตอรี่ของพวกเขาเพื่ออ่าน, การจัดเรียงนี้แทบจะไม่เอื้อต่อการเรียกดูปกติ

คนทั่วไปอ่านเอกสารนี้ได้อย่างไร

ฉันไม่อยากเชื่อว่าผู้ใช้ทั่วไปคาดว่าจะติดตั้งและบำรุงรักษาเว็บเซิร์ฟเวอร์เพียงเพื่ออ่านเอกสารข้อความท้องถิ่น

ส่วนใหญ่ได้รับการพูดและอธิบายอย่างมากโดยjgbelacquaสำหรับใช้ในสถานี เพียงเพิ่มสิ่งนี้สำหรับคนที่อยู่ในผู้จัดการเดสก์ท็อป:

จากเดสก์ท็อปกราฟิก (ที่นี่ GNOME) วิธีที่ง่ายที่สุดในการอ่านเอกสารจาก/usr/share/docคือถึง (ดับเบิล -) คลิกเปิดไฟล์ซิปด้วยเครื่องมือจัดการไฟล์เก็บถาวรมาตรฐานของคุณ (ที่นี่ File Roller) จากที่ที่คุณสามารถ (ดับเบิลคลิก) คลิกเปิดแล้วอ่านใน เครื่องมือแก้ไขมาตรฐานของคุณ (ที่นี่ Gedit) ไม่จำเป็นต้องมีสิทธิ์ในการเขียนตราบใดที่คุณไม่ได้ทำการแตกไฟล์

มีปัญหาอย่างน้อยสองประเด็นที่นี่:

1. อ่านไฟล์. gz อย่างไม่เจ็บปวด
2. สิทธิ์ในไดเรกทอรี
3. (ไม่บังคับสำหรับไฟล์ tex)

สำหรับ# 1มีแอปพลิเคชั่นจำนวนมากที่จัดการกับไฟล์ gzipped ได้อย่างราบรื่น คู่รักที่คุณสามารถใช้เป็นlessและvim.

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

viewเป็นนามแฝงvim -Rซึ่งเพิ่งบอกว่าจะเปิดไฟล์อ่านอย่างเดียว

ในสมัยก่อนที่ติดตั้งน้อยลงในระบบของฉันฉันจะใช้gzcatและท่อส่งออกไปยังยูทิลิตี้อื่น เห็นได้ชัดว่ามันถูกเรียกzcatตอนนี้บน Ubuntu เท่านั้น แต่คุณจะใช้มันในลักษณะนี้เช่น:

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

zcat ยังคงใช้งานได้และการใช้เพื่ออัดเนื้อหาที่บีบอัดบางแห่งอาจมีประโยชน์ในบางกรณี (สำหรับสถานการณ์ที่มีไฟล์. bz2 bzcatจะพร้อมใช้งาน)

สำหรับ# 2ไฟล์ทั้งหมดที่ฉันเห็นภายใต้ / usr / share / doc อยู่ในไดเรกทอรีที่มีสิทธิ์ + rx อื่น ๆ ซึ่งหมายความว่าผู้ใช้ทุกคนสามารถค้นหาไดเรกทอรี (เช่นรายการเนื้อหา) และอ่านไฟล์ภายใน สิ่งที่คุณไม่สามารถทำได้ (เนื่องจากรูทเท่านั้นที่มีสิทธิ์เขียนโดยค่าเริ่มต้น) คือการสร้างไฟล์ เนื่องจากคุณพยายามที่จะคลายซิปลงในไดเรกทอรีนั้นฉันคิดว่ามันให้สิทธิ์แก่คุณที่ถูกปฏิเสธเพราะคุณได้อ่าน แต่ไม่ได้เขียนการอนุญาตตามค่าเริ่มต้น

สำหรับ # 3 ฉันเดาว่าคุณใช้ไฟล์. tex มากกว่าที่คิด แต่นี่เป็นวิธีหนึ่งในการจัดการกับพวกเขาโดยไม่ต้องคัดลอกไปที่บ้านหรือไฟล์ชั่วคราว สำหรับสิ่งนี้คุณจะสร้างไปป์ที่มีชื่อ แต่คุณสามารถนำกลับมาใช้ใหม่ได้สำหรับความต้องการการส่งและการประมวลผล tex อื่น ๆ ของคุณ มันควรเป็นแบบนี้:

• zcat หรือ gzcat ข้อความ
• ... และไพพ์ไปยังโปรเซสเซอร์ TeX ของคุณ
• ... และส่งมันไปที่ Named Pipe ของคุณ (ที่นี่ฉันจะเรียกเขาว่าpipey)
• ... และจากนั้นในหน้าจอแยกคว้าผลลัพธ์ของคุณจาก pipey
• ... และส่งไปยังกระบวนการแสดงผล dvi

คุณสามารถแก้ไขขั้นตอนเหล่านี้ได้อย่างชัดเจนหากคุณใช้ยูทิลิตีอื่นหรือดีกว่าที่นี่

ตัวอย่างของฉันจะใช้mkfifoยูทิลิตีเพื่อสร้างไพพ์ที่มีชื่อ, pipey. /usr/share/doc/gdb/refcard.tex.gzแฟ้มเป้าหมายที่จะดำเนินการคือ คุณจะต้องมีสองบรรทัดคำสั่งเชลล์ (ผ่านเทอร์มินัล, Alt + F2 หรืออย่างไรก็ตาม)

คุณจะพิมพ์เทอร์มินัลหนึ่ง:

mkfifo pipey

ตอนนี้คุณมีไพพ์ที่มีชื่อถาวร คุณสามารถใช้ls -lมองมัน

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

โปรดสังเกตว่าคำสั่งนี้จะไม่ส่งคืนจนกว่าคุณจะทำอะไรกับผลลัพธ์ที่ไปยังไพพ์ที่มีชื่อ

ในเทอร์มินัลสองคุณจะพิมพ์: tex pipey | xdvi

และมันก็ใช้งานได้ดี กระบวนการสามารถปรับแต่งให้ได้ผลลัพธ์ที่สวยกว่า แต่ถ้าคุณกำลังมองหาที่รวดเร็วและไม่ยุ่งเหยิงนั่นเป็นวิธีหนึ่งที่ทำได้

อาจจะสายเกินไปที่จะตอบ แต่ฉันพบวิธีแก้ปัญหาที่ดีที่สุด (ใช้งานง่ายและครบถ้วน)

• ติดตั้งdwww

ระบบ Linux ทั่วไปมีเอกสารประกอบในหลายรูปแบบ (หน้าแบบแมนนวล, ไฟล์ข้อมูล, READMEs และอื่น ๆ ) dwww ทำให้สามารถเข้าถึงสิ่งเหล่านี้ผ่านทางอินเทอร์เฟซเดียวกันซึ่งเป็นเบราว์เซอร์ WWW ทำให้ง่ายต่อการใช้เอกสาร

dwww เป็นเว็บอินเตอร์เฟสสำหรับเอกสารออนไลน์ทั้งหมดในระบบ Debian มันสร้างบางหน้าเว็บที่แสดงรายการเอกสารที่ติดตั้งทั้งหมดและแปลงเอกสารทั้งหมดเป็น HTML การแปลงเสร็จสิ้นเมื่อผู้ใช้ร้องขอเอกสาร

• เปิดใช้งานโมดูล CGI ซึ่งไม่ได้เปิดใช้งานตามค่าเริ่มต้นใน Ubuntu / Apache ล่าสุด:

  sudo a2enmod cgi
  sudo service apache2 restart
  

• เปิดเบราว์เซอร์ของคุณและชี้ไปที่: http: // localhost / dwww /

• ทำ!

ทั้งหมดของinfoหน้าmanเพจ/usr/share/docไฟล์และรายละเอียดแพคเกจในที่เดียว! เว็บไซต์เอกสารส่วนตัวของคุณ!

gunzip file.gzความพยายามที่จะยกเลิกการบีบอัดfile.gzเพื่อลบfile file.gzนั่นคือเหตุผลที่คุณได้รับ "อนุญาตปฏิเสธข้อผิดพลาด" /usr/share/docคุณไม่ได้รับอนุญาตให้เขียนใน เพื่อให้ได้เนื้อหาของแฟ้มการใช้งานหรือgunzip -c file.gzzcat file.gz

อ่าน textfiles gzip zlessบีบอัดที่สามารถทำได้ด้วย ตามที่ชื่ออาจแนะนำเป็นเพียงlessแต่สำหรับไฟล์ที่บีบอัด gzip

ตัวอย่างการใช้งาน:

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/ของคุณผ่านเว็บเบราว์เซอร์ของคุณ http://localhost/doc/ไปๆมาๆ

สิ่งนี้ไม่ได้ผล คุณต้องเปลี่ยนการกำหนดค่าของ Apache เพื่อให้มันขยายขนาดและแสดงไฟล์ * .gz เป็นข้อความธรรมดา

ฉันโพสต์บน Stack Overflowเพื่อรับวิธีการใช้ Apache เพื่อแสดงเนื้อหาของเอกสาร * .gz ใน/usr/share/doc/ไดเรกทอรี นี่คือสิ่งที่โพสต์เป็นวิธีแก้ปัญหาที่เป็นไปได้

นี่คือคำแนะนำสั้น ๆ เหล่านั้น มันบอก 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