الگو:Man
The Single UNIX® Specification, Issue 7 from The Open Group
– Reference,To be used for inserting صفحه راهنما links into articles on یونیکس topics.
Usage
ویرایشExamples
ویرایشIn Out {{man|3|printf}}
The Single UNIX® Specification, Issue 7 from The Open Group – Reference,{{man|3|printf|||inline}}
{{man|3|printf|FreeBSD}}
FreeBSD Library Functions Manual –{{man|3|printf||formatted output conversion}}
The Single UNIX® Specification, Issue 7 from The Open Group : formatted output conversion – Reference,
Parameters
ویرایش- Manual section
- Manual page name
- Source (the name of a ویکیپدیا:زیرصفحه in the الگو:Man فضای نام (علوم رایانه) e.g. الگو:Man/FreeBSD. Leave blank for the current الگو:Man/SUS.)
- Page description
- Style parameter; currently
inline
omits the attribution.
Available sources
ویرایشPlease add to this table as you write new sources!
Source Example Result default[۱] {{man|cu|ls}}
The Single UNIX® Specification, Issue 7 from The Open Group – Commands & Utilities Reference,die.net {{man|1|ls|die.net}}
لینوکس دستورات کاربری صفحه راهنما –Version 7 Unix {{man|1|ls|v7}}
Version 7 Unix Programmer's Manual –4.2BSD {{man|1|ls|4.2BSD}}
4.2BSD General Commands Manual –4.3BSD {{man|1|ls|4.3BSD}}
4.3BSD General Commands Manual –4.3BSD-Reno {{man|1|ls|4.3BSD-Reno}}
BSD General Commands Manual –4.4BSD-Lite2 {{man|1|ls|4.4BSD-Lite2}}
BSD General Commands Manual –9front {{man|1|ls|9front}}
الگو:Man/9front –Darwin {{man|1|ls|Darwin}}
داروین (سیستمعامل) and اواسده General Commands صفحه راهنما –Debian {{man|1|ls|Debian}}
Debian General Commands Manual –man.cx {{man|8|iptables|man.cx|inline}}
DragonFly BSD {{man|1|ls|DragonFly BSD}}
DragonFly General Commands Manual –FreeBSD {{man|1|ls|FreeBSD}}
FreeBSD General Commands Manual –HP-UX {{man|1|ls|HP-UX}}
HP-UX 11i User Commands Manual –Inferno {{man|1|ls|Inferno}}
Inferno General commands Manual –IRIX {{man|1|ls|IRIX}}
IRIX 6.5 User Commands Manual –BIND 9 {{man|1|named|BIND 9}}
BIND 9 –Linux[۲] {{man|7|epoll|Linux}}
Linux Programmer's Manual – Overview, Conventions and Miscellanea –ManKier {{man|1|ls|ManKier}}
الگو:Man/ManKier –MirOS BSD {{man|1|ls|MirOS BSD}}
الگو:Man/MirOS BSD –NetBSD {{man|1|ls|NetBSD}}
NetBSD General Commands Manual –OpenBSD {{man|1|ls|OpenBSD}}
OpenBSD General Commands Manual –OpenSolaris {{man|1|ls|OpenSolaris}}
OpenSolaris User Commands Reference Manual from latest Sun based OpenSolaris –perldoc[۳] {{man|1|perlrun|perldoc}}
Perl Programming Documentation –Plan 9 {{man|1|ls|Plan 9}}
Plan 9 Programmer's Manual, Volume 1 –Solaris {{man|1|ls|Solaris}}
Solaris 10 User Commands Reference Manual –SUS {{man|cu|ls|SUS}}
The Single UNIX® Specification, Issue 7 from The Open Group – Commands & Utilities Reference,SUS6 {{man|sh|putmsg|SUS6}}
The Single UNIX® Specification, Issue 6 from The Open Group – System Interfaces Reference,
- ↑ Redirects to the current default
- ↑ Note: this covers all sections, including section 1 of the Linux user's manual and sections 2, 3, 4, 5, 6, 7, and 8 of the Linux programmer's manual.
- ↑ Note: this is the official documentation included with پرل. It does not contain general manual pages.
Other sources
ویرایشOccasionally you will come across manual pages for which writing a source is overkill. In this case you can use الگو:Man/format directly with a URL for formatting:
In Out {{man/format|1|dbx|http://.../dbx.1.html|source-level debugging tool|[[Sun Studio]] Developer's Manual}}
Sun Studio Developer's Manual : source-level debugging tool –
The interface of الگو:Man/format is therefore externally visible and needs to be kept constant.
Hacking
ویرایشWriting sources
ویرایشA source takes three parameters:
- Manual section
- Manual page name
- Output selector:
attrib
for attributionurl
for URL to pagedisplay_section
for section to display in parentheses.
See الگو:Man/die.net for an example; see الگو:Man/FreeBSD for a demonstration of varying the attribution by manual section.
Internals
ویرایشالگو:Man handles choosing the default source and calling it for URL and attribution; the default source is الگو:Man/SUS, which is a template redirect currently to الگو:Man/die.net. الگو:Man/format actually formats the link and descriptions into a nice-looking link+auxilia in Unix style.