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: Semantic markup for config file name/value pairs?


Jaime Irving Davila wrote:

> On thu, 22-05-2003 at 07:25, Steinar Bang wrote
> 
>>>Is there something in DocBook XML 4.1.2, that can be used for
>>>semantic markup of names and sample values for name/value pairs in
>>>config files?
>>>
> 	I am not sure, but maybe <property> [1] can help you in this case.
> 
> [1] http://www.docbook.org/tdg/en/html/property.html


Element "property" is interesting. (nonexistent) Elements "value" and 
"values" might be interesting too?

Stuff like

   http://www.w3.org/TR/REC-CSS2/colors.html#colors
   http://www.w3.org/TR/REC-CSS2/visuren.html#display-prop

could be marked up like

<variablelist>
   <varlistentry>
     <term>
       <property>display</property>
     </term>
     <listitem>
       <values>
         <value>inline</value>
         <value>block</value>
         <value>list-item</value>
         <value>run-in</value>
         <!-- ... -->
       </values>
     </listitem>
   </varlistentry>
   <varlistentry>
     <term>
       <property>color</property>
     </term>
     <listitem>
       <values>
         <value>inherit</value>
         <value><replaceable>color</replaceable></value>
       </values>
     </listitem>
   </varlistentry>
   <varlistentry>
     <term>
       <property>foo</property>
     </term>
     <listitem>
       <!-- single value -->
       <value>bar</value>
     </listitem>
   </varlistentry>
</variablelist>

Disclaimers :)
a) Perhaps elements exist to do this in a similiarly concise way, and I 
missed them.
b) DocBook will someday be even larger than now.
c) Some might say this is too close to being modeling.

Tobi

-- 
http://www.pinkjuice.com/



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