Unix and Linux Discussions Tagged with faq |
|
Thread / Thread Starter |
Last Post |
Replies |
Views |
Forum |
|
|
|
2 |
29,584 |
Answers to Frequently Asked Questions |
|
|
|
3 |
20,235 |
Answers to Frequently Asked Questions |
|
|
|
6 |
8,022 |
UNIX for Beginners Questions & Answers |
|
|
|
1 |
4,386 |
UNIX for Beginners Questions & Answers |
|
|
|
14 |
12,213 |
AIX |
|
|
|
2 |
26,337 |
UNIX for Beginners Questions & Answers |
|
|
|
7 |
32,979 |
What is on Your Mind? |
|
|
|
1 |
14,669 |
Answers to Frequently Asked Questions |
|
|
|
4 |
1,877 |
UNIX for Beginners Questions & Answers |
|
|
|
7 |
3,065 |
Shell Programming and Scripting |
|
|
|
11 |
2,428 |
Shell Programming and Scripting |
|
|
|
2 |
3,104 |
AIX |
|
|
|
1 |
9,461 |
Answers to Frequently Asked Questions |
|
|
|
3 |
7,078 |
UNIX for Advanced & Expert Users |
|
|
|
9 |
3,218 |
Shell Programming and Scripting |
|
|
|
5 |
4,808 |
AIX |
|
|
|
8 |
4,753 |
UNIX for Beginners Questions & Answers |
|
|
|
1 |
11,790 |
Answers to Frequently Asked Questions |
|
|
|
39 |
14,698 |
OS X (Apple) |
|
|
|
5 |
30,313 |
Answers to Frequently Asked Questions |
|
|
|
3 |
11,647 |
Answers to Frequently Asked Questions |
|
|
|
2 |
12,586 |
Answers to Frequently Asked Questions |
|
|
|
6 |
12,496 |
Answers to Frequently Asked Questions |
|
|
|
0 |
12,530 |
Answers to Frequently Asked Questions |
|
|
|
8 |
17,733 |
Answers to Frequently Asked Questions |
|
|
|
1 |
18,413 |
Answers to Frequently Asked Questions |
|
|
|
21 |
395,721 |
Fedora |
|
|
|
4 |
3,983 |
UNIX for Dummies Questions & Answers |
|
|
|
8 |
12,643 |
Shell Programming and Scripting |
|
|
|
28 |
11,736 |
UNIX for Dummies Questions & Answers |
|
|
|
7 |
8,371 |
AIX |
|
|
|
5 |
14,891 |
Answers to Frequently Asked Questions |
|
|
|
1 |
17,537 |
Tips and Tutorials |
|
|
|
1 |
16,371 |
Answers to Frequently Asked Questions |
|
|
|
1 |
15,100 |
Answers to Frequently Asked Questions |
|
|
|
1 |
8,567 |
AIX |
|
|
|
8 |
5,489 |
UNIX for Dummies Questions & Answers |
|
|
|
6 |
5,173 |
Shell Programming and Scripting |
|
|
|
1 |
21,719 |
Answers to Frequently Asked Questions |
|
|
|
18 |
24,576 |
Shell Programming and Scripting |
pud-faq(7) MISCELLANEOUS pud-faq(7)
NAME
pud-faq - faqs and facts about the Portable Unix Documentation FAQ authoring language.
This document describes the Portable Unix Documentation (PUD) faq mini-language in the style of a FAQ. PUD-faq is built on top of the
macro interpreter zoem. A PUD document is generally well-structured, relatively free of formatting statements, compact to write and eas-
ily extendable. It can be converted to both troff and html, for viewing in terminals and browsers. High quality Postscript and plain
text formats can be derived from the troff output. Refer to pud-man for examples.
DESCRIPTION
The PUD faq macros extend the PUD manual macros; a PUD faq document must import both man.zmm and faq.zmm. There are only a few addi-
tional faq macros in faq.zmm. The overall layout of a faq document is as follows:
import{man.zmm}
import{faq.zmm}
egin{pud::man}{
{name}{pud-faq}
{html_title}{The PUD faq mini-language FAQ}
{author}{Stijn van Dongen}
{section}{7}
}
"faq::preamble"
${html}{"man::maketoc"}
sec{toc}{TOC}
"faq::maketoc"
egin{faqsec}{{ref}{Labelx}{cap}{Captionx}}
content
end{faqsec}
egin{faqsec}{{ref}{Labely}{cap}{Captiony}}
content
end{faqsec}
end{pud::man}
The PUD manual macros are documented in the pud-man manual page.
Create your FAQ according to the lay-out above and as described further below. Refer to Question 2.3 for full-size examples.
Once you have written your FAQ, process it as follows.
zoem -i your-faq.azm -d html
zoem -i your-faq.azm -d html
zoem -i your-faq.azm -d roff -o your-faq.7
zoem -i your-faq.azm -d roff -o your-faq.7
This generates files your-faq.html and your-faq.7. Each device is run twice to be certain that references are found and linked.
RESOURCES
o The Zoem User Manual.
o The pud-man manual page.
TOC
1...... How do I create and link to questions and sections?
1.1... How do I start a section?
1.2... How do I make a faq entry?
1.3... How do I link to a question?
1.4... How do I link to a section?
1.5... Is that not a whole lot of typing just for linking?
2...... Miscellaneous
2.1... Is it really possible to have more than one section?
2.2... Is there an easy way to get back to the TOC?
2.3... Show me a real FAQ, not this nonsense.
2.4... I want to change the appearance of my FAQ.
2.5... Show me the source to this FAQ.
FAQ
How do I create and link to questions and sections?
1.1 How do I start a section?
You would for example type
egin{faqsec}{
{ref}{kind}
{cap}{How do I link to questions and sections?}
}
1.2 How do I make a faq entry?
You create an entry as follows:
faq{q_question}{How do I make a faq entry?}
You create an entry as follows:
...
1.3 How do I link to a question?
car{Like this: linking to
iref{q_qlink}{Question~
efnumber{q_qlink}},
or a silly link to the iref{q_qlink}{current question}.
Linking to iref{s_basics}{Question~
efnumber{q_slink}},
or a link to the iref{q_slink}{next question}.}
par{
Of course, you have to use wordings such that the
text still makes sense in the absence of links
(assuming you are intested in the troff version of
the FAQ you are writing), so normally you just refer to
iref{q_slink}{Question~
efnumber{q_slink}} and be done
with it.}
Like this: linking to Question 1.3, or a silly link to the current question. Linking to Question 1.4, or a link to the next question.
Of course, you have to use wordings such that the text still makes sense in the absence of links (assuming you are intested in the troff
version of the FAQ you are writing), so normally you just refer to Question 1.4 and be done with it.
1.4 How do I link to a section?
car{Like this: linking to
iref{q_qlink}{Section~
efnumber{s_basics}} and
linking to iref{q_stupid}{Section~
efnumber{s_stupid}}.}
Like this: linking to Section 1 and linking to Section 2.
1.5 Is that not a whole lot of typing just for linking?
It sure is. Note the repeating elements though. Feel free to create your own shortcuts by using Zoem's macro facilities.
Miscellaneous
2.1 Is it really possible to have more than one section?
QED
2.2 Is there an easy way to get back to the TOC?
In the HTML version of the faq, one can click on the number to the left of the question; this will take you to the top of the TOC part
pertaining to the section that question belongs to.
2.3 Show me a real FAQ, not this nonsense.
The reason I began writing zoem and PUD was that I wanted decent (both HTML and troff) and easy to write documentation for my implemen-
tation of the MCL cluster algorithm.
o http://micans.org/mcl/src/mcl-latest/doc/mclfaq.azm
o http://micans.org/mcl/src/mcl-latest/doc/mclfaq.html
o http://micans.org/mcl/src/mcl-latest/doc/mclfaq.ps
2.4 I want to change the appearance of my FAQ.
Well, you need to make a copy of the faq macros and possibly the man macros, and hack those changes in. Zoem itself is very flexible,
but the PUD faq macros are not, in this respect. They can be made so, if you wish. If you just want to change or add some style sheet
rules for the HTML version, it will be quite easy. The same holds for changing font styles and possibly even spacing rules.
2.5 Show me the source to this FAQ.
Search for pud-faq.azm in your install of zoem. Take note though that I played a few silly tricks in this FAQ, so the source looks more
unreadable than your average FAQ. The FAQ pointed to in Answer 2.3 gives a more realistic impression.
AUTHOR
Stijn van Dongen.
SEE ALSO
The pud-man manual page, documenting the PUD manual language. The FAQ language imports the manual definitions and you use these e.g. for
sectioning commands as described above.
The pud manual page gives an overview of PUD.
pud-faq 1.002, 10-008 8 Jan 2010 pud-faq(7)