<?xml version="1.0" encoding="ISO-8859-1"?>
<sect1 id="intro-borges-sect1">
 <sect1info>
  
  <!-- Please, do NOT edit the following revision history by hand. Use the
  "make <module_name>.revision" target instead.  -->
  
  <revhistory><revision><revnumber>0.8</revnumber><date>YYYY-MM-DD</date><authorinitials>tbn</authorinitials><revremark>write</revremark> </revision><revision><revnumber>0.8</revnumber><date>YYYY-MM-DD</date><authorinitials>tbn</authorinitials><revremark>translate</revremark> </revision><revision><revnumber>0.8</revnumber><date>YYYY-MM-DD</date><authorinitials>tbn</authorinitials><revremark>tproof</revremark> </revision><revision><revnumber>0.8</revnumber><date>YYYY-MM-DD</date><authorinitials>tbn</authorinitials><revremark>pproof</revremark> </revision><revision><revnumber>0.8</revnumber><date>YYYY-MM-DD</date><authorinitials>tbn</authorinitials><revremark>ispell</revremark> </revision><revision><revnumber>0.8</revnumber><date>YYYY-MM-DD</date><authorinitials>tbn</authorinitials><revremark>lproof</revremark> </revision>
      <revision>
        <revnumber>1.en.lproof</revnumber>
        <date>YYYY-MM-DD</date>
        <authorinitials>tbn</authorinitials>
      </revision>
      <revision>
        <revnumber>1.en.ispell</revnumber>
        <date>YYYY-MM-DD</date>
        <authorinitials>tbn</authorinitials>
      </revision>
      <revision>
        <revnumber>1.en.pproof</revnumber>
        <date>2002-07-22</date>
        <authorinitials>jp</authorinitials>
      </revision>
      <revision>
        <revnumber>1.en.tproof</revnumber>
        <date>2002-07-02</date>
        <authorinitials>cb</authorinitials>
      </revision>
      <revision>
        <revnumber>1.en.write</revnumber>
        <date>2002-06-18</date>
        <authorinitials>jp</authorinitials>
      </revision>
    </revhistory>
 </sect1info>
 
 <title id="intro-borges-sect1-ti1">What is Borges?</title>
 
 <para id="intro-borges-sect1-pa1">&prog-borges; is an open source
  extensible documents management system aimed at &xml; aware
  documentation projects. It's main purpose is to optimize
  internationalization (many languages, translations), reusable
  content and teamwork.</para>

  <para id="intro-borges-sect1-pa2">The main philosophy behind
  &prog-borges; is to provide a convenient tool:<itemizedlist>
      <listitem>
	<para id="intro-borges-sect1-pa3">For beginners: by providing
	a very simple interface to compile &xml; DocBook documents
	into various formats;</para>
      </listitem>
      <listitem>
	<para id="intro-borges-sect1-pa4">For advanced users: by
	providing a whole set of customization features allowing to
	easily twick every single aspect of the system: output formats
	and layout, custom rules, etc.</para>
      </listitem>
      <listitem>
	<para id="intro-borges-sect1-pa5">For project managers: by
	providing a powerful project tracking system to juggle with
	authors and translators, deadlines, etc. </para>
      </listitem>
    </itemizedlist>
</para>

 <sect2>
  <title id="intro-borges-sect1-ti2">Features</title>
  
    <para id="intro-borges-sect1-pa6">The supported &dtd;s are DocBook
   and <acronym>TDB</acronym> (Training DocBook), a subset of the
   DocBook &dtd; written for the training manuals of
   MandrakeSoft. Adding external &dtd;s is very easy, even though the
   revision checking system might not work yet with &dtd;s other than
   DocBook and <acronym>TDB</acronym>.</para>

  <para id="intro-borges-sect1-pa7">Currently, the system allows to:
   <itemizedlist>
    <listitem>
     <para id="intro-borges-sect1-pa8">Compile the source files into
     &pdf;, &ps; and &xhtml;;</para>
    </listitem>
    <listitem>
     <para id="intro-borges-sect1-pa9">Manage different versions of a
      single document by easily defining derived versions based on
      conditional parts;</para>
    </listitem>
    <listitem>
     <para id="intro-borges-sect1-pa10">Each module is assigned a set
      of authors: writer/ translators/ proofreaders, each one
      responsible for one state of a module. Each contributor can
      easily review his attributions through web pages, and can
      receive e-mails with his current todo list;</para>
    </listitem>
    <listitem>
     <para id="intro-borges-sect1-pa11">Track the work in
      progress. From the whole project (made of various documents) to
      the most basic components (paragraphs), and their
      translations;</para>
    </listitem>
    <listitem>
     <para id="intro-borges-sect1-pa12">Track the state of each module
     according to six predefined states. (From &quot;written&quot; to &quot;final
     language proofreading&quot;). Once a task is completed, the
     corresponding state is passed and the module switches to the next
     state;</para>
    </listitem>
   </itemizedlist>
  </para>

  <para id="intro-borges-sect1-pa13">Quick facts about &prog-borges;:
   <itemizedlist>
    <listitem>
     <para id="intro-borges-sect1-pa14" revision="1">automatic
      management of images in &eps;, &png;, &jpg;, &prog-dia;,
      &prog-xfig; formats;</para>
    </listitem>
    <listitem>
     <para id="intro-borges-sect1-pa15">automatic management of global
      and local (per document) external entities;</para>
    </listitem>
    <listitem>
     <para id="intro-borges-sect1-pa16">automatic management of
      modules as external entities.</para>
    </listitem>
   </itemizedlist>
  </para>
 </sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-parent-document: ("../../manuals/module/psgml-top.xml" "sect1")
End:
-->