[drupal-docs] Docbook ++ question

puregin puregin at puregin.org
Sat Apr 23 04:40:43 UTC 2005


On 22 Apr 2005, at 9:05 PM, Anisa wrote:

>> puregin wrote:
>>
>>      It would be very useful to have a single point of access in 
>> terms of
>> searching all of this.  Anyone up for writing a simple search
>> aggregator which is hip to Drupal content?  Perhaps leverage
>> the built in search capabilities of Drupal.org, as well as Google and 
>> ?
>
>
> Drupal.org already has a search for all its content.  I could 
> potentially see adding list mails to that, but not the code api you 
> see on drupaldocs.org.

      Sometimes it's nice to see everything in one place- for example, I 
think it would be
useful in terms of trying to pull content from the forums and mailing 
lists into
the handbook.
>
>>> However, it is also fairly complicated, so there were definite  
>>> disadvantages on the authoring side...  authors have to learn a new  
>>> type of markup to use it, which is a pretty major barrier.
>>
>>     Another advantage of DocBook is that it can be viewed as providing
>> structural extensions of HTML.  So, at the  level of typing content,  
>> it's
>> not completely unfamiliar. If we are using Drupal's book module, this
>> will provide structure at the level of parts, chapters, sections...
>>
>> This means that in terms of DocBook, we will be working with elements
>> at the level of paragraphs,  lists, tables, images, and such - not
>> so unfamiliar.
>>
> One thing I liked about the Doc Books Wiki is it takes even that 
> unfamiliarity out of the equation.

           Seems too good to be true.  I hope that it really does work
as promised!

>>
>>     I haven't looked recently at the issues, but I'd like to
>> see support for adding a child to a given book page
>> via a link, and a treetable navigation and editing
>> scheme.   Lots of work available for someone talented
>> with JavaScript :)   And no doubt opening the door
>> for another spirited debate about the virtues/evils
>> of JS.
>
> I am confused!  The book module does this.  The handbook does this.  
> What version is your Drupal?

      Ah! You're right about the child node feature.  I must be living 
in the stone age...  time to
upgrade.

     Djun

--
puregin at puregin.org
http://www.puregin.org




More information about the drupal-docs mailing list