เชื่อมโยงไปยังส่วนหน้าคน?

หน้าคนออนไลน์ใน HTML พร้อมจุดยึด?

มันจะเป็นการดีถ้าคุณมีอูบุนตูเวอร์ชันออนไลน์ที่มีลิงก์โดยตรงไปยังส่วนย่อย ที่อนุญาตให้ชี้บุคคลไปยังเอกสารที่เกี่ยวข้องในหลายกรณีตัวอย่างเช่นคำตอบของเว็บไซต์ StackExchange ต่างๆ

ฉันจะอธิบายถึงวิธีการแก้ปัญหาอย่างเต็มรูปแบบอาจมีลักษณะและวิธีที่จะเป็นประโยชน์ ฉันไม่คิดว่าวิธีแก้ปัญหาที่สมบูรณ์นั้นมีอยู่ที่ใดที่หนึ่งดังนั้นคำถามก็คือ

มีโซลูชั่นใดบ้างในปัจจุบัน

ตัวอย่างเช่นวิธีที่เป็นระบบในการค้นหาใน man pages แทนที่จะเป็นการเชื่อมโยงจะเป็นวิธีการบางส่วน

man page ที่manpages.ubuntu.comแก้ปัญหาส่วนใหญ่ได้ แต่ไม่มีจุดยึดที่ส่วนหัวหรือส่วน

ซึ่งหมายความว่าหากฉันต้องการชี้ไปที่ส่วน "การขยายพารามิเตอร์" ใน man bashออนไลน์ฉันต้องใช้

ดู "การขยายพารามิเตอร์" ใน [... และใช้เบราว์เซอร์ของคุณเพื่อค้นหา "การขยายพารามิเตอร์"]man bash

วิธีนี้จะเปิดหน้า bash man ที่ด้านบนเป็นหน้าเว็บที่ยาวหนึ่งหน้า

ในเปลือกฉันสามารถพูดได้

ดู man bash | less "+/Parameter Expansion"

ซึ่งข้ามไปยังตำแหน่งที่ถูกต้องเมื่อเริ่มต้น

มันจะมีประโยชน์มากหากมีลิงก์ชื่อที่เชื่อมโยงกับหัวเรื่องที่พวกเขาชี้ไป จุดยึดที่ตั้งชื่อตามหมายเลขดัชนีบางประเภทจะยังคงช่วยได้อยู่ แต่ต้องใช้การค้นหาด้วยตนเองบนหน้าเว็บจริงเพื่อใช้งาน

เนื่องจากระดับ HTML นั้นไม่ยากที่จะเพิ่มแองเคอร์ไปที่ส่วนหัวฉันแน่ใจว่ามีหน้าคนดังกล่าวอยู่
แต่มีคอลเลกชันของหน้า man Ubuntu ที่มีจุดยึดออนไลน์อยู่ที่ไหนสักแห่งหรืออย่างน้อยก็เป็นเซตย่อยที่ดี?

รหัสตัวอย่าง

ส่วนหัวของส่วน "การขยายพารามิเตอร์" จาก
http://manpages.ubuntu.com/bash
ชนิดใดที่เปลี่ยนเส้นทางไปที่
http://manpages.ubuntu.com/manpages/trusty/en/man1/bash.1.html

       [ ... ]
       tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>,  and  <b>CDPATH</b>,  and  the  shell
       assigns the expanded value.

   <b>Parameter</b> <b>Expansion</b>
       The `<b>$</b>' character introduces parameter expansion, command substitution,
       or arithmetic expansion.  The parameter name or symbol to  be  expanded
       [ ... ]

เพื่อให้สามารถเชื่อมโยงโดยตรงกับส่วนนี้เราต้องการ:

       [ ... ]
       tildes in assignments to <b>PATH</b>, <b>MAILPATH</b>,  and  <b>CDPATH</b>,  and  the  shell
       assigns the expanded value.

   <a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
       The `<b>$</b>' character introduces parameter expansion, command substitution,
       or arithmetic expansion.  The parameter name or symbol to  be  expanded
       [ ... ]

สิ่งนี้จะเพิ่มแท็กหนึ่งไปยังรหัส HTML และหนึ่งแอตทริบิวต์ชื่อส่วนที่ไม่มีช่องว่าง:

<b>Parameter</b> <b>Expansion</b>
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>

ตอนนี้เราสามารถเชื่อมโยงไปยังส่วนที่ชอบ

http://manpages.ubuntu.com/bash#ParameterExpansion
หรือแม้แต่
manpages.ubuntu.com/bash#ParameterExpansion

ซึ่งใช้ foot note และเขียนเหมือน
[manpages.ubuntu.com/bash#ParameterExpansion เหมือนพี่น้อง 6]

การใช้เอกสารอ้างอิงอื่น ๆ

ในหลายกรณีมีเอกสารอ้างอิงทางเลือกอื่น ๆ ปรากฏขึ้นจากหน้า man เหล่านี้มักจะมีโครงสร้างลิงค์ที่ดีที่ใช้ในการเชื่อมโยงจากสารบัญไปยังส่วนต่างๆเพียงแค่สิ่งที่เราต้องการ
แต่สิ่งนี้ไม่ได้แก้ปัญหาทั่วไปเนื่องจากไม่มีวิธีการทั่วไปในการค้นหาว่าเอกสารอยู่ที่ใดและมีการใช้โครงสร้างลิงก์หรือไม่

สำหรับตัวอย่าง bash ที่ใช้ด้านบนคู่มืออ้างอิง Bashสามารถใช้เป็นโซลูชันแยกต่างหากค้นหาด้วยตนเอง:

คู่มืออ้างอิง Bash ส่วน Shell-Parameter-Expansion
เขียนเป็น
[คู่มืออ้างอิง Bash ส่วน Shell-Parameter-Expansion] (http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)

การดำเนินการที่เสนอ

เพื่อนำเสนอการดำเนินการจริงความคิดนี้ที่manpages.ubuntu.com ,
ฉันยื่นคำขอข้อผิดพลาด / การเพิ่มประสิทธิภาพที่เกี่ยวข้องอย่างใกล้ชิดในโครงการที่เกี่ยวข้อง "อูบุนตู-manpage-พื้นที่เก็บข้อมูล": Launchpad # 1355271: ใช้ HTML แท็กที่จะช่วยให้การเชื่อมโยงภายนอกในการย่อยของมนุษย์ หน้า

ใช่มีก็http://man.cx/ มันมีจุดมุ่งหมายที่จะมีหน้าคนทั้งหมดในเว็บไซต์เดียวในหลายภาษา แองเคอร์นั้นไม่มีชื่อ แต่มีหมายเลข: ตัวอย่างเช่นhttp://man.cx/printf#heading1จะนำคุณไปสู่ส่วนหัวแรกของprintfหน้าเว็บ ยังฉันคิดว่ามันจะดีกว่าโดยไม่ต้องเบรก;)

PS เพิ่มไซต์ลงในเครื่องมือค้นหาของคุณจากนั้นคุณสามารถพิมพ์man printfในแถบที่อยู่ของคุณและมันจะนำคุณไปสู่หน้าที่ถูกต้องสุดยอดมาก!

บนunix.stackexchangeมีวิธีอธิบายให้ใช้ manpages ออฟไลน์เป็นไฮเปอร์เท็กซ์เช่นกัน วิธีที่ง่ายที่สุดสำหรับฉันดูเหมือนว่า w3mman ซึ่งเป็นส่วนหนึ่งของแพ็คเกจw3mดังนั้น:

sudo apt-get install w3m

เมื่อคุณเปิด man page w3mman manคุณสามารถใช้TABเพื่อนำทางไปยังลิงค์ถัดไป (แป้นพิมพ์ลัดทั่วไปแบบอื่น ๆ ก็ใช้งานได้เหมือนกันคือการเลื่อนการค้นหาการเลิก :-)

หากต้องการปิดการยืนยันการออก (เช่นmanพฤติกรรม):

• แก้ไข ~/.w3m/config

  • หากไม่มีอยู่: cp /etc/w3m/config ~/.w3m/

• ชุด confirm_qq 0

ในการแทนที่คำสั่งmanปกติ:

• แก้ไข ~/.bashrc

  • เพิ่ม alias man='w3mman'

• source ~/.bashrc

ตอนนี้man <some command>จะใช้ w3mman แทนคนธรรมดา :) ฉันชอบแบบนี้ ขอบคุณที่ถาม! :)