[Bf-docboard] What about a chapter for "3D
Concepts & Fundamentals"
Bart Veldhuizen
bf-docboard@blender.org
04 Jan 2003 11:59:00 +0100
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>