[DOCS] Need help with SGML again

2003-10-13 Thread Josh Berkus
Folks,

I'm augmenting runtime-config as requested.  However, I am finding myself 
daunted by all the hand-coding SGML I have to do.  Can someone do some 
handholding for me?

Particularly, I'd like to know how to:
cross-link to another item on the same page;
producte a bulleted or numbered list;

Help on IRC would be best if possible

Thanks.

-- 
-Josh Berkus
 Aglio Database Solutions
 San Francisco


---(end of broadcast)---
TIP 8: explain analyze is your friend


Re: [DOCS] Need help with SGML again

2003-10-13 Thread Roberto Mello
On Mon, Oct 13, 2003 at 09:01:45PM -0700, Josh Berkus wrote:
> Folks,
> 
> I'm augmenting runtime-config as requested.  However, I am finding myself 
> daunted by all the hand-coding SGML I have to do.  Can someone do some 
> handholding for me?
> 
> Particularly, I'd like to know how to:
> cross-link to another item on the same page;
> producte a bulleted or numbered list;

The OpenACS Docbook Primer should give you what you need:

http://openacs.org/doc/openacs-4-6-3/docbook-primer.html

It is for Docbook XML, which (AFAIK, might be wrong) is a superset of
Docbook SGML, but by looking at ohter examples in the docs you shoul dbe
able to assert that by yourself.

There's also the HOWTO-HOWTO from the Linux Documentation Project
(tldp.org)

-Roberto

-- 
+|Roberto Mello   -http://www.brasileiro.net/  |--+
+   Computer Science Graduate Student, Utah State University  +
+   USU Free Software & GNU/Linux Club - http://fslc.usu.edu/ +
Quer um Chokito? Então pôe o dedo na tomadita!

---(end of broadcast)---
TIP 6: Have you searched our list archives?

   http://archives.postgresql.org


Re: [DOCS] Need help with SGML again

2003-10-13 Thread Jeroen Ruigrok/asmodai
Hi Josh,

-On [20031014 06:12], Josh Berkus ([EMAIL PROTECTED]) wrote:
>Particularly, I'd like to know how to:
>cross-link to another item on the same page;
>producte a bulleted or numbered list;

SGML or XML can't do that by themselves.  You would need a DTD for that,
such as DocBook.

Within DocBook (www.docbook.org) you would use:

 for cross-links:

Go to blah page

and

 for a list with bullets or dingbats or  for a
list with incremental numbering.


  blah

  fu


HTH,

-- 
Jeroen Ruigrok van der Werven  / asmodai / kita no mono
PGP fingerprint: 2D92 980E 45FE 2C28 9DB7  9D88 97E6 839B 2EAC 625B
http://www.tendra.org/   | http://www.in-nomine.org/~asmodai/diary/
Only the wisest and the stupidest of men never change...

---(end of broadcast)---
TIP 8: explain analyze is your friend