On Sun, Jan 12, 2003 at 10:21:57AM -0500, Dan Espen wrote:
> Olivier Chapuis <[EMAIL PROTECTED]> writes:
> > On Sat, Jan 11, 2003 at 10:32:32PM -0500, Dan Espen wrote:
> > > Olivier Chapuis <[EMAIL PROTECTED]> writes:

> > > However the .sgml is really hard to read. 
> > > The markup gets in the way.
> > > I don't know if I'd like trying to edit the sgml with emacs or vi.
> > 
> > I do not understand. Really, SGML, XML and HTML is very very similar
> > at the editor level and you say that you would like to use HTML.
> 
> The massive amount of markup in docbook format makes it hard
> to actually read the text.
> 
> I realized that XEmacs wasn't highlighting the document by default.
> I made some adjustments and I got some of the stuff to highlight but
> theres still a huge amount of markup in the file.  I see that
> SGML mode has a command to hide most of the markup which helps, but a
> quick test shows that you can't edit with the markup hidden.
> (Stuff gets put in the wrong place.)
> 
> Right now I'd say that this is still a problem, but not a big one.
> I'd guess after I get used to sgml-mode, there might be more benefits
> than problems.
>

What we can do (and I experiment this) is to add aliases.  This
involve to extand the dtd and to preprocess the document with a filter
style-sheet. Currently:

<acronym>   --> <ac>
<emphasis>  --> <em>
<quote>     --> <q>
<command>   --> <cmd>
<envar>     --> <ev>
<filename>  --> <f>
<option>    --> <opt>
<optional>  --> <otn>
<parameter> --> <pmt> and <pr> (for fvwm parameter reference)
<userinput> --> <ui>
...etc.

and we can add
<fc>: for fvwm commands
<fcr>: for fvwm commands references (see <fcr>KillModule</fcr>)
<fp>: for fvwm parameters
<fpr>: for fvwm  parameters references

I think that smaller MarkUp may help reading/editing the source.
Also, we may remove from the dtd some the Markup that we do not want
to use.
 
> 
> I see that Docbook supports images.  I guessed that we still
> couldn't use images because we want to convert Docbook to manpage
> format.  I haven't looked at the process to convert Docbook
> to man, but is there some way to mark text in such a way that
> it will not appear in the man page?  I'm thinking of:
> 
> <inlineimageref>
> The following shows how a HGradient appears:
> <image>XXX</image>
> </inlineimageref>
> 
> (The whole inlineimageref section would get dropped out when the man
> page was generated.)
>

Yes this is possible.

Olivier
--
Visit the official FVWM web page at <URL:http://www.fvwm.org/>.
To unsubscribe from the list, send "unsubscribe fvwm-workers" in the
body of a message to [EMAIL PROTECTED]
To report problems, send mail to [EMAIL PROTECTED]

Reply via email to