Difference between revisions of "Documentation:Developers Notes"
Jholsenback (talk | contribs) m (added a scratch pad) |
Jholsenback (talk | contribs) m (minor style edits) |
||
| Line 11: | Line 11: | ||
==The Content== | ==The Content== | ||
The repository documents were produced by a perl script ''(makedocs.pl)''. It converts the html files into MediaWiki markup language preserving ''POV-centric'' tags that are critical to the final creation of distribution documentation sets. MediaWiki markup understands many standard html tags, so by in large most things get passed on ''as-is'', however there are some exceptions that are covered in the tag [[Documentation:Developers Notes#Tag Summary|summary]] below. | The repository documents were produced by a perl script ''(makedocs.pl)''. It converts the html files into MediaWiki markup language preserving ''POV-centric'' tags that are critical to the final creation of distribution documentation sets. MediaWiki markup understands many standard html tags, so by in large most things get passed on ''as-is'', however there are some exceptions that are covered in the tag [[Documentation:Developers Notes#Tag Summary|summary]] below. | ||
| + | ==Configuration== | ||
| + | :* When [http://www.mediawiki.org/wiki/Manual:Opening_external_links_in_a_new_window#Dynamically_defining_an_href_target| this] change is implemented .... [http://www.povray.org/|_new <span title="Opens A New Window!">links</span>] should open in a new window. | ||
==Tag Summary== | ==Tag Summary== | ||
This section is a list of the tags, by classification, with a brief synopsis of how it was handled and why. | This section is a list of the tags, by classification, with a brief synopsis of how it was handled and why. | ||
| Line 30: | Line 32: | ||
These are just some tags/classes I'm talking about: | These are just some tags/classes I'm talking about: | ||
| − | : | + | :* <nowiki>class="Explain"</nowiki> |
| − | : | + | :* <nowiki><code></code></nowiki> |
| − | : | + | :* <nowiki><pre></pre></nowiki> |
| − | : | + | :* <nowiki>class="Note"</nowiki> |
| − | : | + | :* Others .... |
====Left Justified==== | ====Left Justified==== | ||
There were a number of html tags that just didn't work as you'd expect, until the became the first character of a new line. There are also certain wiki tags that have the same requirement, so I had to get rid of leading tabs and spaces. | There were a number of html tags that just didn't work as you'd expect, until the became the first character of a new line. There are also certain wiki tags that have the same requirement, so I had to get rid of leading tabs and spaces. | ||
| − | |||
| − | |||
Revision as of 09:41, 21 February 2009
|
This document is protected, so submissions, corrections and discussions should be held on this documents talk page. |
Introduction
This document is an outline of the process used to generate the content of the documentation repository.
The Source
The html files used to generate this content came from the current documentation generation process (povdocgen) input side files.
The Content
The repository documents were produced by a perl script (makedocs.pl). It converts the html files into MediaWiki markup language preserving POV-centric tags that are critical to the final creation of distribution documentation sets. MediaWiki markup understands many standard html tags, so by in large most things get passed on as-is, however there are some exceptions that are covered in the tag summary below.
Configuration
Tag Summary
This section is a list of the tags, by classification, with a brief synopsis of how it was handled and why.
MUST Preserve
These tags are for indexing and searching purposes. They are critical to down stream processes.
- These is have no end user viewable information so they are commented out.
- <!--<sectiondesc desc="Unix specific">--->
- <!--<indexentry "average, tutorial">--->
- The end user sees this tag as an Intra-Wiki navigational link, so ....
- <linkto "Introduction">Introduction</linkto>
- becomes
- <!--<linkto "Introduction">Introduction</linkto>--->[[Documentation:SomePage#Introduction|Introduction]]
- The end user sees this tag as an Intra-Wiki navigational link, so ....
Style Sheet Issue's
The content will not resemble the Windows distribution, or the online version due to style sheet issues. If making the repository pages look like the distribution is an issue, then integrating elements of povray35.css should be considered, or maybe this would be a great opportunity to change the look of the documentation!
These are just some tags/classes I'm talking about:
- class="Explain"
- <code></code>
- <pre></pre>
- class="Note"
- Others ....
Left Justified
There were a number of html tags that just didn't work as you'd expect, until the became the first character of a new line. There are also certain wiki tags that have the same requirement, so I had to get rid of leading tabs and spaces.