[Bf-docboard] What about a chapter for "3D Concepts & Fundamentals"

[Bart Veldhuizen]

On Thu, 2003-01-02 at 21:33, Felix Rabe wrote:

> > What about inserting a note to ourselves? ('Note: great sources for
> > inspiration here: http://acme.com')
> 
> Yes - or a list of references: (example for a imaginary chapter on 
> Blender licensing with (some) imaginary addresses)
> 
> References
> ^^^^^^^^^^
>    o http://www.blender.org/license.html
>    o http://www.gnu.org/philosophy/free-sw.html
>    o http://www.opensource.org/
>    o http://www.creativecommons.org/
>    o http://www.microsoft.com/licenses/eula.html
>    o http://www.opencontent.org/ocl.html
>    o ...
> 
> To avoid slowing down the progress of actually writing the chapter, it 
> would perhapbs be the best solution to leave that list in plain text (or 
> implement some kind of preprocessor (e.g., refpp.py), that parses the 
> XML sources for such reference sections, and formats it nicely with 
> clickable links (<ulink ...>) and everything).
> 
> We just need a template (or a definitive tag to wrap the reference list 
> in, such as one of <literallayout>, <screen> or <programlisting>).  It 
> would be preferable to have it be automatically processable, so we could 
> (e.g.) extract a summary website from it containing the references used 
> so far, so that later doc. writers can draw upon that list and see 
> whether something could be used a second time for another chapter (or 
> the same chapter, if the resource should have changed in the meantime).

Hmmm, this sounds like overkill to me. What's wrong with a plain text
note with some references?

Bart

-- 
Bart Veldhuizen <bart@vrotvrot.com>