Kılavuz sayfası bölümlerine bağlantı mı oluşturuyorsunuz?


13

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ınman 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


3
Kulağa iyi bir fikir gibi geliyor. Lütfen bunun için bir hata raporu gönderin .
Florian Diesch

@FlorianDiesch Tabii, bu bariz kısım;) Aslında, manpages.ubuntu.com çok temiz bir uygulama gibi görünüyor, ama tek bir geliştirici tarafından yapıldığını hatırlıyorum. Bakalım ...
Volker Siegel


1
@AlaaAli Meta , Ubuntu projesi veya Ubuntu ile ilgili diğer web siteleri hakkında değil, Ask Ubuntu ile ilgili sorular içindir .
Eliah Kagan

1
Bu arada, buraya çok benzer bir soru yazdım: unix.meta.stackexchange.com/q/3960/135943
Wildcard

Yanıtlar:


7

Evet, http://man.cx/ var . Tüm man sayfalarının tek bir sitede, birden çok dilde olmasını hedefler. Bağlantılar maalesef adlandırılmaz, ancak numaralandırılır: örneğin http://man.cx/printf#heading1 sizi printfman sayfasının ilk başlığına götürür . Yine de çapa olmadan daha iyi olduğunu düşünüyorum;)

PS. Siteyi arama motorlarınıza ekleyin, ardından man printfadres çubuğuna yazabilirsiniz ve sizi doğru sayfaya götürecektir, süper harika!


1
Arama motoru olarak tarayıcı entegrasyonu için harika bir fikir!
Philipp Wendler

Yorum yapmadan oy al?
Gerhard Burger

2

Açık unix.stackexchange , yollar tarif vardır hipermetnin gibi çevrimdışı Man sayfaları kullanmak çok. Benim için en kolay yol, paketin bir parçası olan w3mman gibi görünüyor w3m, bu yüzden:

sudo apt-get install w3m

Bir man sayfasını açtığınızda, fe w3mman man, bir TABsonraki bağlantıya gitmek için kullanabilirsiniz . (Diğer tipik klavye kısayolları aynı şekilde çalışır: kaydırma, arama, bırakma :-)

Çıkma onayını kapatmak için ( mandavranış gibi):

  • Düzenle ~/.w3m/config

    • mevcut değilse: cp /etc/w3m/config ~/.w3m/
  • Ayarlamak confirm_qq 0

Normal man komutunu değiştirmek için :

  • Düzenle ~/.bashrc

    • Ekle alias man='w3mman'
  • source ~/.bashrc

Şimdi man <some command>normal adam yerine w3mman kullanacak :) Bu şekilde beğendim. Sorduğunuz için teşekkürler! :)

Sitemizi kullandığınızda şunları okuyup anladığınızı kabul etmiş olursunuz: Çerez Politikası ve Gizlilik Politikası.
Licensed under cc by-sa 3.0 with attribution required.