Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 190087 - Creating a FAQ in GuideXML should be made easier
Summary: Creating a FAQ in GuideXML should be made easier
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs on www.gentoo.org
Classification: Unclassified
Component: New Documentation (show other bugs)
Hardware: All All
: High enhancement (vote)
Assignee: Xavier Neys (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-08-24 20:47 UTC by SpanKY
Modified: 2007-08-25 09:38 UTC (History)
1 user (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description SpanKY gentoo-dev 2007-08-24 20:47:17 UTC
we currently do not have an XSL sheet for creating FAQs ... thus all of our FAQs duplicate information and create a bunch of unordered lists by hand (ugh!)

i wanted to create a new FAQ for the embedded project, but wasnt keen on having to do all the layout and such myself when an XSL would do it all for me
Comment 1 Xavier Neys (RETIRED) gentoo-dev 2007-08-24 21:16:22 UTC
Check /proj/en/gdp/tests/faq.xml
Just use <faqindex> instead of <chapter> as your initial chapter.
faqindex has exactly the same structure as a chapter so that you can write an introduction like many of our FAQs do.
The links to questions will be automatically generated, one section per chapter with one <ul> containing one <li> for each section with a link whose content is the section title. The links use the section id if one exists or the old fashioned #doc_chapX_sectY anchor.

PS: was done before you posted the bug, committed afterwards :)
Comment 2 SpanKY gentoo-dev 2007-08-24 22:46:27 UTC
weak ;)

then let's transition this bug to "/proj/en/faq.xml needs to be updated to use <faqindex>" ... when i looked to see how to do a Gentoo FAQ, i (obviously) looked at how we do the current Gentoo FAQ ...
Comment 3 Xavier Neys (RETIRED) gentoo-dev 2007-08-25 09:38:13 UTC
Committed. Let's FAQ!