
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Proposed announcement etc, 2.nd revision



On Tue, Feb 08, 2000 at 12:11:14PM +0100, Guylhem Aznar wrote:

First of all, sorry for being silently for so long. Let me say a
little more on what has been done. I'm accepting improvement
suggestions. 

> > DocBook stuff.  An "authors guide" is the name that I like for it, becuase
> > it follows the conventions of the LDP (it will definately be a guide sized
> > work).  Basically a larger document covering all of the things that are
> > required or might be necessary for someone to write works to be part of the
> > LDP.  This isn't really something that's ripe for discussion on this thread,
> > but I'm sure it will be hashed out more later.
> 
> Jorge has written a DocBook author guide, it is currently being
> translated in english.

Indeed.
While it's not accessible in English, portuguese readers may find an
on-line copy at
http://ldp-br.conectiva.com.br/~godoy/docbook-HOWTO/usando-docbook.html 

Subjects that I'm talking about:

- system configuration
- catalog use
- author's identification
- e-mail
- links
- tables
- keys representation (F1, CTRL+ALT+DEL, etc.)
- menus and menu shortcuts
- mouse buttons
- citations (bibliographical)
- quotations
- indexes
- emphasizing text
- footnotes
- bulleted lists, ordered lists (numbered), simple lists, variable
  lists, segmented lists.
- program lists
- graphics and pictures
- cross reference
- glossaries

I've also supplied example scripts for converting documents (they will
be simplified for the next release of this HOWTO), customizations
examples, some tips I've found interesting while writing a document,
something about reusability of existing documentation, two examples (a
book and an article).

There are a few things more, but I thought that was the minimal
requirements for using DocBook. I'm also going to supply the SGML (as
usual) of this as an example of how to write a document. 

I tried explaining all I needed to write this document and a few other
documents we are writing here at Conectiva. 

> Who has time enough to write a sgml2man while we're going to move to
> DocBook?

I was going to do that for the next version of the HOWTO, I mean, an
example on writing a man page in DocBook. There is already a sgml2man
(it's called docbook2X) script. I was also going to write a section on
writing a FAQ using DocBook. 
It wasn't done because of the need of releasing this HOWTO ASAP. 

Thanks,
--
Godoy.  <godoy@conectiva.com.br>               GPG Fingerprint
                                         851B B620 626D 2AD0 E783
"Ser poeta não é minha ambição,          E932 1330 BE6D A4A3 0625 
 é minha maneira de estar sozinho"
              - Fernando Pessoa.       Publicações @ Conectiva S.A. 

Except where explicitly stated I speak on my own behalf.
Exceto onde explicitado as declarações aqui feitas são apenas minhas.


--  
To UNSUBSCRIBE, email to ldp-discuss-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
https://www.linuxdoc.org/archives/ldp-discuss/msg04259.html
www.linuxdoc.org
CC-MAIN-2023-14
6422
application/http; msgtype=response
sha1:WZ6GDF5MVQVITXZA2DCO7EWTBLZN7VFO
<urn:uuid:703bfe30-8bf4-4fe5-aba1-e4bc98f35308>
2023-03-21T07:37:43Z
144.76.147.219
text/html
sha1:ZEA5CECGB4VN3X5XXK5XPDNGXT5HAGOP
<urn:uuid:5f03ee17-8f4b-4c2f-a158-d14298d2b735>
https://www.linuxdoc.org/archives/ldp-discuss/msg04259.html
response
<urn:uuid:436b6755-2b2e-49a9-9946-16fb1ef82c87>
isPartOf: CC-MAIN-2023-14
publisher: Common Crawl
description: Wide crawl of the web for March/April 2023
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-67-67-81
software: Apache Nutch 1.19 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 1.4-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: https://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/