[Fwd: Re: [Fwd: Re: Proposal for Implementing a Docbook Editor]]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 





-------- Original Message --------
Subject: 	Re: [Fwd: Re: Proposal for Implementing a Docbook Editor]
Date: 	Thu, 21 May 2009 11:20:26 +1000
From: 	Lana Brindley <lbrindle@xxxxxxxxxx>
Organization: 	Red Hat Asia-Pacific
To: 	Christopher Curran <ccurran@xxxxxxxxxx>
CC: 	Joshua Wulf <jwulf@xxxxxxxxxx>, content-services-staff@xxxxxxxxxx
References: <4A14A4D0.40207@xxxxxxxxxx> <4A14A6E1.6040702@xxxxxxxxxx> <4A14AB88.7060903@xxxxxxxxxx>



Christopher Curran wrote:
Lana Brindley wrote:
Joshua Wulf wrote:
Satya is doing a WYSIWYG docbook editor as a Google SOC project in Fedora. He wants feedback on what tags to provide support for. Please take a look at this list and give some feedback on tags that we use that are not covered in it.

- Josh

-------- Original Message --------
Subject:     Re: Proposal for Implementing a Docbook Editor
Date:     Wed, 20 May 2009 21:47:25 +0530
From:     satya komaragiri <satya.komaragiri@xxxxxxxxx>
Reply-To: For participants of the Documentation Project <fedora-docs-list@xxxxxxxxxx> To: For participants of the Documentation Project <fedora-docs-list@xxxxxxxxxx>



Hello,

I have narrowed down to the following set of tags as the minimum that
Docbook editor will need to support for the initial stages of the
project. It would be great if the list could review them once and
suggest any additions/deletions.


tags:

Top Level:
<article id="ID">
</article>



Section:
<section id="ID">
   <title></title>
</section>



Block Tags:
<para></para>
<screen></screen>
<programlisting></programlisting>

<itemizedlist>
<title></title>
   <listitem>
       <para></para>
   </listitem>
</itemizedlist>

<orderedlist>
<title></title>
   <listitem>
       <para></para>
   </listitem>
<orderedlist>

<procedure>
   <step>
       <para>
       </para>
   </step>
</procedure>

<important>

   <title></title>
   <para></para>
</important>

<tip>
   <title></title>
   <para></para>
</tip>

<note>
   <title></title>
   <para></para>
</note>

<warning>
   <title></title>
   <para></para>
</warning>

<caution>
   <title></title>
   <para></para>

</caution>




Inline:

<firstterm></firstterm>
<application></application>


<command>
   <option></option>

</command>

<package></package>
<filename></filename>
<systemitem></systemitem>
<computeroutput></computeroutput>

Is this tag the same as <programlisting>? I don't know it.

programlisting is for a block of preformatted code. computeroutput is for a single inline output snippet.

Ah-ha! Thanks Chris :)

<userinput></userinput>

<prompt></prompt>


<menuchoice>
   <guimenu></guimenu>
   <guisubmenu></guisubmenu>
   <guimenuitem></guimenuitem>
</menuchoice>

<guibutton></guibutton>
<guiicon></guiicon>
<guilabel></guilabel>

<mousebutton></mousebutton>

<keycombo>
   <keycap></keycap>
</keycombo>

<abbrev></abbrev>
<acronym></acronym>

<abbrev> and <acronym> could both possibly be dropped

and in there place firstterm should be added.

It's in, scroll up.

<emphasis></emphasis>

<quote></quote>

<link></link>

<subscript></subscript>
<superscript></superscript>


<action>

<classname>
<constant>

<errorcode></errorcode>
<errorname></errorname>
<errortype></errortype>

<function></function>
<interface></interface>
<parameter></parameter>
<property></property>
<replaceable></replaceable>
<returnvalue></returnvalue>
<structfield><structfield>
<structname></structname>
<symbol></symbol>
<token></token>
<type></type>
<varname></varname>
<remark></remark>

Also, support for <!--comments-->


Regards,
Satya


The only one I would say is seglist should be in the list of advanced features to implement :)

Actually, that reminds me of <variablelist>, which I use a lot:

<variablelist>
<title></title>
<varlistentry>
<term></term>
<listitem>
<para></para>
</listitem>
</varlistentry>
</variablelist>


I wonder why I didn't get the fedora-docs-list email about this...


Chris


L


--
fedora-docs-list mailing list
fedora-docs-list@xxxxxxxxxx
To unsubscribe: https://www.redhat.com/mailman/listinfo/fedora-docs-list

[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Red Hat 9]     [Yosemite News]     [KDE Users]

  Powered by Linux