Bölüm bağlantılarıyla HTML'deki çevrimiçi sayfalar?
Alt bölümlere doğrudan bağlantıları olan Ubuntu man sayfalarının çevrimiçi bir sürümünün olması iyi olur. Bu, birçok durumda birisinin ilgili belgelere işaret etmesine izin verir - örneğin çeşitli StackExchange sitelerinin yanıtlarında.
Tam bir çözümün nasıl görünebileceğini ve bunun hangi şekillerde yararlı olacağını açıklayacağım. Bir yerde tam bir çözüm olduğunu düşünmüyorum, bu yüzden soru
Bugün hangi kısmi çözümler var?
Örneğin, bağlantı kurmak yerine, man sayfalarında arama yapmanın sistematik yolları kısmi bir çözüm olacaktır.
Manpages.ubuntu.com
adresindeki man sayfaları sorunun çoğunu çözer, ancak başlıklarda veya bölümlerde bağlantı yoktur.
Bu, man bash
çevrimiçi "Parametre Genişletme" bölümüne işaret etmek
istersem,
[... içindeki “Parametre Genişletme” konusuna bakın ve "Parametre Genişletme" yi aramak için tarayıcınızı kullanın
man bash
Bu, uzun bir web sayfası olarak üstteki bash man sayfasını açar.
Kabukta diyebilirim ki
Görmek
man bash | less "+/Parameter Expansion"
başlangıçta doğru yere atlar.
İşaret ettikleri başlıklar gibi adlandırılmış bağlantı çapalarına sahip olmak gerçekten yararlı olacaktır. Bir tür dizin numarasıyla adlandırılan çapalar yine de yardımcı olur, ancak kullanmak için gerçek web sayfasında manuel olarak arama yapılması gerekir.
HTML düzeyinde başlıklara bağlantı eklemek zor olmadığından, eminim bu tür sayfalar var;
Ama çevrimiçi bir yerde çapa ile Ubuntu adam sayfalarının bir koleksiyonu var mı , ya da en azından iyi bir alt küme?
Örnek kod
Adlı Bölüm "Parametre genişlemesi" başlığı
http://manpages.ubuntu.com/bash
hangi tür-of-yönlendirmeye
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
[ ... ]
Doğrudan bu bölümle bağlantı kurabilmek için şöyle bir şeye ihtiyacımız var:
[ ... ]
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
[ ... ]
Bu, HTML koduna bir etiket ve boşluk içermeyen bölüm adı olan bir özellik ekler:
<b>Parameter</b> <b>Expansion</b>
<a href="#ParameterExpansion"><b>Parameter</b> <b>Expansion</b></a>
Şimdi aşağıdaki bölüme bağlantı verebiliriz
http://manpages.ubuntu.com/bash#ParameterExpansion
veya hatta
manpages.ubuntu.com/bash#ParameterExpansion
dipnotu kullanan ve [manpages.ubuntu.com/bash#ParameterExpansion yetersiz[6] gibi yazılan
Diğer referans belgelerin kullanımı
Birçok durumda, kılavuz sayfasından appart olarak alternatif referans belgeleri mevcuttur. Bunlar genellikle bir içerik tablosundan bölümlere, sadece ihtiyacımız olan şeylere bağlamak için kullanılan iyi bir bağlantı yapısına sahiptir.
Ancak bu , genel bir sorunu çözmez , çünkü böyle bir belgenin var olup olmadığını / nerede olduğunu bulmak ve bağlantı yapısını kullanmak için ortak bir yol yoktur.
Yukarıda kullanılan bash örneği için, Bash Referans Kılavuzu manuel olarak aranan bireysel bir çözüm olarak kullanılabilir:
Bash Referans Kılavuzu bölümü Shell-Parameter-Expansion
[Bash Referans Kılavuzu bölümü Shell-Parameter-Expansion]
olarak yazılmıştır
(http://www.gnu.org/software/bash/manual/bash.html#Shell-Parameter-Expansion)
Önerilen uygulama
Bu fikrin uygulanması aslında önermek için manpages.ubuntu.com ,
: ı "ubuntu-manpage-depo" ilişkili proje üzerinde yakından ilişkili hata / geliştirme isteğinde bulunur
bir etiket adamın alt bölümlere dış bağlantılara izin Kullanım HTML: launchpad # 1355271 sayfalar