source: trunk/adm/guides/whatis.xml @ 90

<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE article [
<!ENTITY % isolat1 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat1.ent">
%isolat1;
<!ENTITY % isolat2 SYSTEM "http://www.w3.org/2003/entities/iso8879/isolat2.ent">
%isolat2;
<!ENTITY % isogrk3 SYSTEM "http://www.w3.org/2003/entities/iso8879/isogrk3.ent">
%isogrk3;
<!ENTITY % isopub SYSTEM "http://www.w3.org/2003/entities/iso8879/isopub.ent">
%isopub;
<!ENTITY % isotech SYSTEM "http://www.w3.org/2003/entities/iso8879/isotech.ent">
%isotech;
<!ENTITY % isonum SYSTEM "http://www.w3.org/2003/entities/iso8879/isonum.ent">
%isonum;
<!ENTITY project "SUPERBIB">
]>
<article version="5.0"
xmlns="http://docbook.org/ns/docbook"
xmlns:xl="http://www.w3.org/1999/xlink"
xml:lang="en">
<title>What is &project; ?</title>
  <info>
    <pubdate>$Id$</pubdate>
  </info>

<sect1 xml:id="whatis">
<title>What is &project;</title>
<para xml:id="whatis_for_main">
&project; is dedicated to bibliography and users of a project &hellip; 
</para>
<para>
Imagine you want to know how many publications have been written using your tools or your results : &project; is for you !
</para>
<para>
Using a XML/DocBook bibliography file, you wil be able to produce
HTML and PHP files to see :
<itemizedlist>
<listitem>
<simpara>
All publications,
</simpara>
</listitem>
<listitem>
<simpara>
publications sorted by years with a graph,
</simpara>
</listitem>
<listitem>
<simpara>
publications sorted by authors in a big file,
</simpara>
</listitem>
<listitem>
<simpara>
publications by authors - one in a file,
</simpara>
</listitem>
<listitem>
<simpara>
relation ship between authors,
</simpara>
</listitem>
<listitem>
<simpara>
forms to help authors to update the bibliography.
</simpara>
</listitem>
</itemizedlist>
</para>

<para>
As XML/DocBook bibliography is not very popular, &project; allows you to convert flat bibliography information (using copy/paste on an existing website for example) or <literal>bibtex</literal> into this format.
</para>

<para>
No database is involved in the process. HTML and PHP files just have to be upload to an existing website to be visible everywhere.
</para>
</sect1>

<sect1 xml:id="prerequisites">
  <title>Prerequisites</title>
  <para>
    <application>&project;</application> needs <command>xsltproc</command> and <command>xmlstarlet</command> (XML processors).
  </para>
  <para>
If you need the publications/years graph, <application>&project;</application> 
needs <command>ploticus</command>.
  </para>
  <para>
If you want PDF outputs, <application>&project;</application> needs <command>dblatex</command>.
  </para>
  <para>
If your entry is flat text, <application>&project;</application> needs <command>recode</command>.
  </para>
  <para>
If your entry is bibtext, If your entry is flat text, <application>&project;</application> needs <command>python</command>.
</para>
</sect1>

<!-- ++ 
<sect1 xml:id="include">
  <title>Include</title>
<para>
</para>
</sect1>
-->

</article>