"Fossies" - the Fresh Open Source Software Archive

Member "otl_0.61/doc/README-references" (9 Feb 2010, 863 Bytes) of package /linux/privat/old/otl_0.61.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 references/citations:
    2 
    3 We want to avoid reinventing the wheel... 
    4 
    5 - none of the other implementations seem satisfactory
    6   1. use something like <<bib:tag>> where tag is DocBook ABBREV element  or bibtex tag and presume bibliography itself will be generated outside of otl ?
    7   2. avoid the issue altogether and let user deal with it...
    8 
    9 
   10 
   11 other implementations of references:
   12 
   13 markdown
   14 - only supported by extras (mandown, )
   15 
   16 rst
   17 - treats citations identically to footnotes
   18 
   19 asciidoc
   20 - tries to manage references!
   21 
   22 example from asciidoc page:
   23 
   24 anchors:
   25 
   26 [bibliography]
   27 - [[[taoup]]] Eric Steven Raymond. 'The Art of UNIX
   28   Programming'. Addison-Wesley. ISBN 0-13-142901-9.
   29 - [[[walsh-muellner]]] Norman Walsh & Leonard Muellner.
   30   'DocBook - The Definitive Guide'. O'Reilly & Associates.
   31   1999. ISBN 1-56592-580-7.
   32 
   33 links:
   34 
   35 <<taoup>> links to the taoup reference