साचा:Man/doc
To be used for inserting manual page links into articles on Unix topics.
Usage
[संपादन]Examples
[संपादन]In Out {{man|3|printf}}
Linux Library Functions Manual –{{man|3|printf|||inline}}
{{man|3|printf|FreeBSD}}
FreeBSD Library Functions Manual –{{man|3|printf||formatted output conversion}}
Linux Library Functions Manual : formatted output conversion –
Parameters
[संपादन]- Manual section
- Manual page name
- Source (the name of a subpage in the Template:Man namespace e.g. FreeBSD. Leave blank for the current default.)
- Page description
- Style parameter; currently
inline
omits the attribution.
Available sources
[संपादन]Please add to this table as you write new sources!
Source Example Result die.net[१] {{man|1|man|die.net}}
Linux User Commands Manual –default[२] {{man|1|man}}
Linux User Commands Manual –Darwin {{man|1|man|Darwin}}
Darwin and Mac OS X General Commands Manual –Debian {{man|1|man|Debian}}
Debian General Commands Manual –DragonFly {{man|1|man|DragonFly BSD}}
DragonFly General Commands Manual –FreeBSD {{man|1|man|FreeBSD}}
FreeBSD General Commands Manual –HP-UX {{man|1|man|HP-UX}}
HP-UX 11i User Commands Manual –IRIX {{man|1|man|IRIX}}
IRIX 6.5 User Commands Manual –Linux[३] {{man|7|epoll|Linux}}
Linux Programmer's Manual – Overview, Conventions and Miscellanea –LinuxManPages {{man|1|man|LinuxManPages}}
Linux General Commands Manual on linuxmanpages.com –MirOS BSD {{man|1|man|MirOS BSD}}
MirOS BSD i386 General Commands Manual –NetBSD {{man|1|man|NetBSD}}
NetBSD General Commands Manual –OpenBSD {{man|1|man|OpenBSD}}
OpenBSD General Commands Manual –Plan 9 {{man|1|man|Plan 9}}
Plan 9 General Commands Manual –SUS {{man|cu|man|SUS}}
The Single UNIX® Specification, Issue 7 from The Open Group – Commands & Utilities Reference,Solaris {{man|1|man|Solaris}}
Solaris 10 User Commands Reference Manual –Inferno {{man|1|man|Inferno}}
Inferno General commands Manual –
- ^ Current default
- ^ Redirects to the current default
- ^ Note: this is the Linux programmer's manual. It contains manual pages primarily from sections 2, 3, 4, 5 and 7, and does not cover the usual GNU user utilities.
Other sources
[संपादन]Occasionally you will come across manual pages for which writing a source is overkill. In this case you can use Template: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 Template: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 Template:Man/die.net for an example; see Template:Man/FreeBSD for a demonstration of varying the attribution by manual section.
Internals
[संपादन]Template:man handles choosing the default source and calling it for URL and attribution; the default source is Template:man/default, which is a template redirect currently to Template:man/die.net. Template:man/format actually formats the link and descriptions into a nice-looking link+auxilia in Unix style.