Trang người đàn ông trực tuyến trong HTML với phần neo?
Sẽ rất tốt nếu có một phiên bản trực tuyến của các trang người dùng Ubuntu với các liên kết trực tiếp thành các phần phụ. Điều đó sẽ cho phép chỉ ra ai đó đến tài liệu có liên quan trong nhiều trường hợp - ví dụ như trong câu trả lời của các trang web StackExchange khác nhau.
Tôi sẽ mô tả một giải pháp đầy đủ có thể trông như thế nào, và theo cách nào sẽ hữu ích. Tôi không nghĩ rằng một giải pháp hoàn chỉnh có sẵn ở đâu đó, vì vậy câu hỏi là
Những giải pháp một phần tồn tại ngày nay?
Ví dụ, bằng cách nào đó, các cách có hệ thống để tìm kiếm vào các trang man, thay vì liên kết, sẽ là một giải pháp một phần.
Các trang man tại manpages.ubfox.com giải quyết hầu hết các vấn đề, nhưng chúng không có các neo trên các tiêu đề hoặc các phần.
Điều đó có nghĩa là, nếu tôi muốn trỏ đến phần "Mở rộng tham số" trong
man bashtrực tuyến, tôi phải sử dụng
Xem "Mở rộng tham số" trong [... và sử dụng trình duyệt của bạn để tìm kiếm "Mở rộng tham số"]
man bash
Điều này sẽ mở trang bash man ở trên cùng, dưới dạng một trang web dài.
Trong vỏ, tôi có thể nói
Xem
man bash | less "+/Parameter Expansion"
mà nhảy đến đúng nơi khi khởi động.
Sẽ rất hữu ích khi có các liên kết neo được đặt tên giống như các tiêu đề mà chúng trỏ đến. Các neo được đặt tên theo một số loại chỉ số vẫn sẽ có ích, nhưng yêu cầu tra cứu thủ công trên trang web thực tế để sử dụng nó.
Vì mức độ HTML không khó để thêm các neo vào các tiêu đề, tôi chắc chắn các trang man như vậy tồn tại;
Nhưng có một bộ sưu tập các trang người đàn ông Ubuntu có neo trực tuyến ở đâu đó, hoặc ít nhất là một tập hợp con tốt không?
Mã ví dụ
Tiêu đề của phần "Mở rộng tham số" từ
http://manpages.ubfox.com/bash
, loại chuyển hướng nào đến
http://manpages.ubfox.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
[ ... ]Để có thể liên kết trực tiếp đến phần này, chúng tôi cần một cái gì đó như:
[ ... ]
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
[ ... ]
Điều này thêm một thẻ vào mã HTML và một thuộc tính, tên phần không có dấu cách:
<b>Parameter</b> <b>Expansion</b>
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
Bây giờ, chúng ta có thể liên kết đến phần như
http://manpages.ubfox.com/bash#ParameterExpansion
hoặc thậm chí
manpages.ubfox.com/bash#ParameterExpansion
trong đó sử dụng ghi chú chân và được viết như
[manpages.ubuntu.com/bash#ParameterExpansion[[6]
Sử dụng các tài liệu tham khảo khác
Trong nhiều trường hợp, có sẵn các tài liệu tham khảo thay thế, xuất hiện từ trang man. Chúng thường có cấu trúc liên kết tốt được sử dụng để liên kết từ một bảng nội dung đến các phần, chỉ là những gì chúng ta cần.
Nhưng điều này không giải quyết được vấn đề chung , vì không có cách chung để tìm xem liệu tài liệu đó có tồn tại hay không và sử dụng cấu trúc liên kết.
Đối với ví dụ bash được sử dụng ở trên, Hướng dẫn tham khảo Bash có thể được sử dụng như một giải pháp riêng lẻ được tra cứu thủ công:
Phần hướng dẫn tham khảo Bash Shell-Parameter-Expansion
được viết dưới dạng
[Phần hướng dẫn tham khảo Bash Shell-Parameter-Expansion] (http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)
Đề xuất thực hiện
Để đề xuất thực sự thực hiện ý tưởng này tại manpages.ubfox.com ,
tôi đã gửi một yêu cầu cải tiến / lỗi liên quan chặt chẽ đến dự án liên quan " ub Ubuntu-manpage-repository":
launchpad # 1355271: Sử dụng thẻ HTML để cho phép các liên kết bên ngoài đến phần phụ của con người trang