OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Re: [docbook] Re: making macros


Chris Chiasson wrote:

>That's ok, I can't figure out how to make Docbook 5 work either. One
>day tho, one day.
>  
>
It seems to involve endless reading ... made *far* more difficult by the 
disparity of the tool approaches.  Me, I'm a commandlline type pperson, 
so my second step, after figuring where to unpack it all (done, 
finally!) is trying to fix the catalogs.  The 5.0 catalogs are greatly 
different than the 4.4.0 ones, and I can't yet find any docs on fixing 
this.  I saw a ference, though, to a "install.sh" that didn't do the 
conventional job, mimicing the bsd install tool ... instead, it acted 
according to some notes I found, like the old 'elm' installer.  I need 
to find that dude.

I have a complete Gnome xml installation, so that serves as a great 
base.  All the libxml tools work (xmllint, xmlfw, xslproc, xmlcatalog, 
others).  Really nice, and when you read the C code they hide, you can 
figure a lot out.

In figuring out how to actually parse xml, i used Python, which 
implements 3 really nice method families: SAX2, DOM, and ElementTree.  
The SAX2 one is event based, like John Clark's old expat tools; the DOM 
one is far larger (I think( and implements (not completely) the W3 Dom 
spec, which builds the entire tree.  The Really nice ElementTree 
interface doesn't follow a standard, but it's *completely* implemented, 
far smaller, complete in capabilities, ane a joy to code with.  I wrote 
a demonstration system to manage my shopping lists, and it stores all 
the data in xml.

If you wanted that, you could have it, but it's not pretty.  I'm a much 
more utilitarian programmer, so my code all looks like 1980 database 
programs.

Getting my abilities working for Docbook seems to me to be the next step 
in completing my xml-education.

>On 4/25/06, Chuck Robey <chuckr@chuckr.org> wrote:
>  
>
>> Steinar Bang wrote:
>>
>>
>>
>>
>>
>> Chuck Robey <chuckr@chuckr.org>:
>>
>>
>>
>> ... My goal was, I thought, to create a set of macros implemented
>>in something like xsltproc, allowing me to create a set of vim
>>macros so i could write docbook text (I have several topics ready
>>for me) in my chosen editor.
>>
>> The DocBook wiki pointed me to this one:
>> http://www.vim.org/scripts/script.php?script_id=301
>>
>>I haven't tried it myself since I'm an emacs user (I still use the
>>good old nsgml, though. As long as it works for me I haven't felt the
>>need to take the step to nxml).
>>
>>You might find other editors in the wiki of interest:
>> http://wiki.docbook.org/topic/DocBookAuthoringTools
>>
>>The important part is to find an editor that understands the
>>DTD/schema, and adapts to it. Then the editor will tell you what tags
>>are legal at any given point, what children and attributes are
>>required, etc.
>>
>> OK, with all the good info I have now, I am giving up my goal of writing a
>>set of docbook-macros as (take your pick, here) either impractical, already
>>done, or not really needed in light of the simple versions already existing.
>>
>> I have a good vim setuup working for editing.  Installed, working.
>>
>> I have listened to the marketing info, and decided that the data on
>>docbook-5.x was very persuasive, and it convinced me.  Unfortunately, I have
>> a Mac fink system here (I'm a dyed in the blue core Unix fan) with the
>>Gnome Docbook tools, using docbook version 4.2, and I can't yet locate any
>>info on how to install the docbook 5.(whatever I choose, haven't picked yet)
>>without goofing up the existing Gnome installation.
>>
>> So, I need better install pointers than I've found so far, and not ones
>>that tell me how to write it, you folks have been fantastic at supplying
>>that.
>>
>> BTW, and I won't bore you with it, but a computer system that begins with
>>the Mac, adds fink and X11 and Gnome, is a technical user's wet dream.  If
>>any of you nice folks want such a system tell me you're from this list, and
>>consider your bill totally paid-in-full.  I would be overjoyed to give you
>>help.  Don't spread that past this list please.  Really.
>>
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail:
>>docbook-unsubscribe@lists.oasis-open.org
>>For additional commands, e-mail:
>>docbook-help@lists.oasis-open.org
>>
>>
>>
>>---------------------------------------------------------------------
>>To unsubscribe, e-mail:
>>docbook-unsubscribe@lists.oasis-open.org For additional
>>commands, e-mail: docbook-help@lists.oasis-open.org
>>    
>>
>
>
>--
>http://chris.chiasson.name/
>  
>



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]