Forum OpenACS Q&A: Response to HowTo on raising shared memory

Collapse
Posted by Pascal Scheffers on
You can find more on the DocBook things in this thread. You need to fetch the ldp.dsl and install it the right way. The direct URL for the LDP howto: http://www.linuxdoc.org/LDP/LDP-Author-Guide/usingldpdsssl.html.

To edit them docs I suggest you use Emacs, it will make life not just a whole lot easier, but goes from impossible to very doable. There are a couple of Emacs keybindings that will save the day:

  • C-c <: insert a tag, with context sensitive auto completions [press tab or enter]: If a tag is not allowed according to the DTD, emacs won't insert it.
  • C-c /: closes the last open tag.
  • There are more, for a full set of (SGML) keybindings: C-h b
Another neat thing is the document validation checker (in one of the menus, don't know the keybinding). Remember to use the extension .sgml, otherwise Emacs will not figure out you're doing sgml, AFAIK.

If you get the latest acs3-pg from CVS, you'll find a readme in acs3-pg/www/doc/openacs/src explaining howto create the HTMLs from the SGML. Have fun.