Šablóna:Man

z Wikipédie, slobodnej encyklopédie
Skočit na navigaci Skočit na vyhledávání

{{{2}}} – Reference, The Single UNIX Specification, Issue 7 from The Open Group

Túto dokumentáciu [upraviť] [história] [obnoviť]
Dokumentácia Dokumentácia

Používa sa na vkladanie odkazov na manuálové stránky v článkov o Unixových témach.

Použitie

Príklady

Formát Výstup
{{man|3|printf}} printf – System Interfaces Reference, The Single UNIX Specification, Issue 7 from The Open Group
{{man|3|printf|||inline}} printf
{{man|3|printf|FreeBSD}} printf(3) – FreeBSD Library Functions Manual
{{man|3|printf||formatted output conversion}} printf: formatted output conversion – System Interfaces Reference, The Single UNIX Specification, Issue 7 from The Open Group

Parametre

  1. Sekcia manuálovej stránky
  2. Názov manuálovej stránky
  3. Zdroj (meno podstránky v Šablona:Man namespace e.g. FreeBSD. Nechaj prázdne pre default.)
  4. Popis manuálovej stránky
  5. Parameter štýlu – momentálne inline vynecháva uvedenie zdroja.

Available sources

Keď budeš pridávať nový zdroj, doplň ho sem do tabuľky.

zdroj príklad výsledok
default[1] {{man|1|ls}} ls – Commands & Utilities Reference, The Single UNIX Specification, Issue 7 from The Open Group
die.net {{man|1|ls|die.net}} ls(1) – Linux User Commands Manual
Version 6 Unix {{man|1|ls|v6}} ls(1) – Version 6 Unix Programmer's Manual
Version 7 Unix {{man|1|ls|v7}} ls(1) – Version 7 Unix Programmer's Manual
4.2BSD {{man|1|ls|4.2BSD}} ls(1) – 4.2BSD General Commands Manual
4.3BSD {{man|1|ls|4.3BSD}} ls(1) – 4.3BSD General Commands Manual
4.3BSD-Reno {{man|1|ls|4.3BSD-Reno}} ls(1) – BSD General Commands Manual
4.4BSD-Lite2 {{man|1|ls|4.4BSD-Lite2}} ls(1) – BSD General Commands Manual
9front {{man|1|ls|9front}} ls(1) – 9front manual page
Darwin {{man|1|ls|Darwin}} ls(1) – Darwin and macOS General Commands Manual
Debian {{man|1|ls|Debian}} ls(1) – Debian General Commands Manual
man.cx {{man|8|iptables|man.cx|inline}} iptables(8)
DragonFly BSD {{man|1|ls|DragonFly BSD}} ls(1) – DragonFly BSD General Commands Manual
FreeBSD {{man|1|ls|FreeBSD}} ls(1) – FreeBSD General Commands Manual
HP-UX {{man|1|ls|HP-UX}} ls(1) – HP-UX 11i User Commands Manual
Inferno {{man|1|ls|Inferno}} ls(1) – Inferno General commands Manual
IRIX {{man|1|ls|IRIX}} ls(1) – IRIX 6.5 User Commands Manual
BIND 9 {{man|1|named|BIND 9}} named – BIND 9
Linux[2] {{man|7|epoll|Linux}} epoll(7) – Linux Programmer's Manual – Overview, Conventions and Miscellanea
ManKier[2] {{man|1|ls|ManKier}} ls(1) – Linux General Commands Manual
MirOS BSD {{man|1|ls|MirOS BSD}} ls(1) – MirOS BSD i386 General Commands Manual
NetBSD {{man|1|ls|NetBSD}} ls(1) – NetBSD General Commands Manual
OpenBSD {{man|1|ls|OpenBSD}} ls(1) – OpenBSD General Commands Manual
OpenSolaris {{man|1|ls|OpenSolaris}} ls(1) – illumos and OpenSolaris User Commands Reference Manual from latest Sun based OpenSolaris
perldoc[3] {{man|1|perlrun|perldoc}} perlrun(1) – Perl Programming Documentation
Plan 9 {{man|1|ls|Plan 9}} ls(1) – Plan 9 Programmer's Manual, Volume 1
Solaris {{man|1|ls|Solaris}} ls(1) – Solaris 10 User Commands Reference Manual
SUS[4] {{man|cu|ls|SUS}} ls – Commands & Utilities Reference, The Single UNIX Specification, Issue 7 from The Open Group
SUS6[4] {{man|sh|putmsg|SUS6}} putmsg – System Interfaces Reference, The Single UNIX Specification, Issue 6 from The Open Group
  1. Presmeruje na aktuálne predvolené nastavenia
  2. a b Poznámka: toto sa vzťahuje na všetky sekcie vrátane sekcie 1 používateľskej príručky systému Linux a sekcií 2, 3, 4, 5, 6, 7 a 8 príručky programátora Linux.
  3. Poznámka: Toto je oficiálna dokumentácia zahrnutá v Perl. Nezahrňuje všeobecné manuálové stránky.
  4. a b Poznámka: Stránky SUS používajú nečíselný systém kapitol. Pre ľudské pohodlie je pripravené jednoduché mapovanie.

Iné zdroje

Občas narazíte na manuálne stránky, pre ktoré je písanie zdroja fuška. V takom prípade môžete použiť Šablóna:man/format priamo s adresou URL na formátovanie:

Formát Výstup
{{man/format|1|dbx|http://.../dbx.1.html|source-level debugging tool|[[Sun Studio]] Developer's Manual}} dbx(1): source-level debugging tool – Sun Studio Developer's Manual

Priamo je možné používať rozhranie Šablona:Man/format a nový pridaný zdroj sa musí riadiť touto konvenciu.

Hacking

Písanie zdrojov

Zdroj ma tri parametre:

  1. manuálovú sekciu
  2. názov manuálovej stránky
  3. vystupnú voľbu:
    • attrib pre uvedenie zdroja
    • url pre URL na stránku
    • display_section pre zobranie sekciu v zátvorke.

Viď napríklad Šablona:Man/die.net; pozri Šablona:Man/FreeBSD na ukážku zmeny atribútu manuálnej sekcie.

Interné

Šablona:Man rieši výber predvoleného zdroja a jeho volaním na adresu URL a uvedenie zdroja; východiskovým zdrojom je Šablona:Man/default, čo aktuálne presmerovaná na šablónu Šablona:Man/die.net. Aktuálne Šablona:Man/format formátuje odkaz a popis odkazu do pekného Unixovo-štýlovaného odkazu.



Ak máte otázku k tejto šablóne, alebo potrebujete jej rozšírenie a neviete ho správne naformátovať, pýtajte sa v diskusii k šablóne. Pokiaľ je potrebné šablónu urgentne opraviť, obráťte sa na technickú podporu. Na testovanie šablóny môžete vytvoriť testy šablóny.