Re: [docbook] Re: Semantic markup for config file name/value pairs?

[Tobias Reif <tobiasreif at pinkjuice dot com>]

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/


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@lists.oasis-open.org
For additional commands, e-mail: docbook-help@lists.oasis-open.org