<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <meta content="text/html; charset=ISO-8859-1" http-equiv="content-type"> <title>introduction</title> </head> <body> <ol id="mozToc"> <!--mozToc h1 1 h2 2 h3 3 h4 4 h5 5 h6 6--><li><a href="#mozTocId173847">Introduction </a> <ol> <li><a href="#mozTocId877742">Main Features</a></li> <li><a href="#mozTocId619815">Changes</a></li> <li><a href="#mozTocId963068">Installation</a> <ol> <li><a href="#mozTocId91969">Windows</a> <ol> <li><a href="#mozTocId85945">With OpenOffice.org > 1.9.x </a></li> <li><a href="#mozTocId769316">With OpenOffice.org 1.1.x</a></li> </ol> </li> <li><a href="#mozTocId425952">GNU/Linux</a> <ol> <li><a href="#mozTocId157381">Debian packages</a> <ol> <li><a href="#mozTocId44987">Using OOo1.1.x </a></li> <li><a href="#mozTocId551738">Using OOo2.0</a></li> </ol> </li> <li><a href="#mozTocId903848">Other linux</a></li> </ol> </li> </ol> </li> <li><a href="#mozTocId42081">Starting Bibus</a></li> </ol> </li> </ol> <h1><a class="mozTocH1" name="mozTocId173847"></a>Introduction<br> </h1> <p>Bibus is a bibliographic database.<br> It has been developed with OpenOffice.org (<a href="http://www.openoffice.org/">http://www.openoffice.org/</a>) in mind. This means that the database is modeled on OpenOffice.org bibliographic database engine. As such it has the features and most of the limitations of this format. However, one of the most annoying limitation which is the restriction to 80 characters of any field, has been addressed in bibus where the fields are 255 character long (or even unlimited, depending on the database engine used).<br> However, Bibus is in development and there are many evolutions planed for the OpenOffice.org <a href="http://bibliographic.openoffice.org/">bibliographic</a> engine. Bibus will try to evolve alongside these changes.<br> Is Bibus stable enough for using it on a daily basis? As usual, Bibus is distributed WITHOUT ANY WARRANTY and you must use it at your own risk. However, since the heart of Bibus is the database engine (MySQL and SQLite) and since it is not possible to delete a reference in Bibus, I think the risk to get a catastrophic crash is very low. You must however remember to make regular backups of the database. If you use SQLite, you just have to copy the database file. If you use MySQL the easiest way is probably to use mysqldump (mysqldump -p Biblio > biblio.sql).<i><br> </i></p> <h2><a name="mozTocId877742"></a>Main Features</h2> <ul> <li> <p style="margin-bottom: 0cm;">Compatible with two database engines: MySQL <<a href="http://www.mysql.com/">http://www.mysql.com/</a>> and SQLite <<a href="http://www.sqlite.org/">http://www.sqlite.org/</a>>. </p> </li> <li> <p style="margin-bottom: 0cm;">Hierarchical organization of the references with user defined keys. </p> </li> <li> <p style="margin-bottom: 0cm;">Drag & drop and Copy/Paste to easily organize references.</p> </li> <li> <p style="margin-bottom: 0cm;">Designed for multiuser: </p> <ul> <li> <p style="margin-bottom: 0cm;">You can share the database between an "unlimited" number of users. </p> </li> <li> <p style="margin-bottom: 0cm;">Each user will have his/her own classification.</p> </li> <li> <p>You can hav read-only and read-write users<br> </p> </li> </ul> </li> <li> <p style="margin-bottom: 0cm;">Powerful and easy to use search engine. </p> </li> <li> <p style="margin-bottom: 0cm;">Live queries, i.e searches that will update when the database changes (this is simply a saved SQL query).</p> </li> <li> <p style="margin-bottom: 0cm;">On-line <a href="http://www.ncbi.nlm.nih.gov/entrez/query.fcgi?db=PubMed">PubMed</a> access. </p> </li> <li> <p style="margin-bottom: 0cm;">Import PubMed (Medline), <a href="http://www.ecst.csuchico.edu/%7Ejacobsd/bib/formats/endnote.html">EndNote/Refer</a>, RIS and BibTeX records.</p> </li> <li> <p>Export to PubMed, Refer and RIS.</p> </li> <li> <p style="margin-bottom: 0cm;">Connection to <a href="http://www.openoffice.org/">OpenOffice.org</a>. You can insert references in an open OpenOffice.org text document and format the bibliography directly in Bibus.<br> </p> </li> <li> <p style="margin-bottom: 0cm;">Thanks to Python and wxWidget, Bibus should work on most modern platform (<a href="http://www.linux.org/">GNU/linux</a> with gtk; Windows; MacOS ?; etc...). </p> </li> <li> <p>Foreign language support through unicode and gettext. For the moment, Bibus is available in English, French, Portuguese and Danish. Feel free to translate it in your favorite language, this is easy and fast. It took me about 1 hour to translate the bibus.pot file in French. </p> </li> </ul> <h2><a name="mozTocId619815"></a>Changes</h2> <p>For a complete listing of the changes, see <a href="../../CHANGELOG">CHANGELOG.</a></p> <pre>1.2.0<br> New features<br> ------------<br> * Bibus now communicate both with OOo and MS Word<br> * New display of references in Main window<br> * Improved Windows installer<br> * Freezed Windows version<br> * Installable on FlashKey on Windows<br> Bug fix<br> ------- <br> * compatibility with pysqlite2/pysqlite1.1/pysqlite1.0 improved<br> * compatibility with MySQL4.0/4.1 improved<br> * resize problem of Reference editor fixed<br> * fix import filters when date is empty<br> * import filters now use TITLE for booktitle instead of BOOKTITLE (used only for inBook, inCollection)<br>1.1.1<br> * compatible with python-sqlite2. You must update your old database<br> * compatible with MySQL41. You must update your old database<br> * References are displayed/printed/copied according to the current format<br> * bug fixes<br>1.1.0<br>Note added after 1.1.0 release:<br> * contrary to what is said in the Changelog file, bibus is NOT COMPATIBLE with python-sqlite version 2.<br> * Compatible with OOo2.0 and 1.1<br> * Compatible with python-sqlite2<br> * Compatible with MySQL4.1<br> * Fast display of long lists<br> * BibTeX import from Nigel Sim <nigel.sim@jcu.edu.au><br> * New translations (partial)<br> * Portugese translation by Vitor Figueiro <vfigueiro@gocial.pt><br> * chinese translation by <max.ouyang@gmail.com><br> * spanish translation by Pablo Rodriguez <ousia@gmx.net><br> * German translation by Andreas Morasch <a.mor@web.de><br> * Czech translation by Daniel Rajdl <<a href="mailto:Daniel%20Rajdl%20%3crajdl@fnplzen.cz%3e">rajdl@fnplzen.cz</a>><br> * Gestion of duplicates during import<br> * Complete rewrite of the OOo connection for portability and speed<br>1.0.0<br> * Added new styles for field formatting (free combination of bold, italic, underline, caps, smallcaps)<br> * New command to go to the current doc in OpenOffice<br> * BibliograpicType is now displayed as 'ARTICLE', 'BOOK', etc... instead of 0,1,2,...<br> * Double clicking a imported references allows to see all the fields<br> * Possibility to import references without saving them first<br> * Column width may now be fixed<br> * reference list sorting improved (up/down + arrow)<br>pre1.0.0<br> * portugese translation<br> * complete styles<br> * work with wxPython2.5<br> * work with mysql-python 1.1.x<br> * work with PySQLite 1.1.x<br> * remember window position and size<br> * simplified install (to be improved)<br> * many bug fixes<br>0.9.0<br> * Greatly improved styles<br> * First connection wizard to help setting Bibus<br> * First rudimentary author-date implementation<br>0.8.2<br> * maintenance release<br>0.8.1<br> * Added connection with OpenOffice.org using Pipe (in addition to TCP/IP)<br> * tested on Windows98, 2000 and linux<br> <br>0.8.0<br> * First public release<br> * Tested on debian Gnu/linux unstable and Windows2000</pre> <h2><a class="mozTocH2" name="mozTocId963068"></a><a name="mozTocId469761"></a>Installation</h2> <b><font color="#ff0000">The installation here is mainly obsolete.<br> For up-to-date informations please read the <a href="http://bibus-biblio.sourceforge.net/wiki/index.php/Installation">installation doc online</a>.</font></b><a href="http://bibus-biblio.sourceforge.net/wiki/index.php/Installation"></a><br> <h3><a name="mozTocId91969"></a>Windows</h3> <h4><a class="mozTocH5" name="mozTocId85945"></a>With OpenOffice.org > 1.9.x<br> </h4> <ul> <li> <p style="margin-bottom: 0cm;">Install OpenOffice.org from <a href="http://www.openoffice.org/">www.openoffice.org.</a> The current version is <a href="http://www.openoffice.org"><span style="text-decoration: underline;">2.0.1</span></a><br> </p> <ul> <li> <p style="margin-bottom: 0cm;">By default it should install in C:\Program Files\OpenOffice.org 2.0\<br> </p> </li> </ul> </li> <li> <p style="margin-bottom: 0cm;">Install <a href="http://www.python.org/ftp/python/2.3.5/Python-2.3.5.exe">python2.3.5</a> from www.python.org. <font color="#ff0000">Use 2.3.x version and not a more recent or earlier release since it will not work with OpenOffice.org 2.0<br> </font></p> <ul> <li> <p style="margin-bottom: 0cm;">By default it should install in C:\Program Files\Python23\ </p> </li> </ul> </li> <li> <p style="margin-bottom: 0cm;">Install <a href="http://prdownloads.sourceforge.net/wxpython/wxPython2.6-win32-unicode-2.6.2.1-py23.exe">wxPython2.6.2.1 </a>from www.wxpython.org. Pay attention to get a version with unicode support and compiled for python2.3.</p> </li> <li>SQLite: PySQLite for python2.3 from <<a href="http://pysqlite.org/">http://pysqlite.org/</a>>. You can use any version but I recommend:</li> <ul> <li><a href="http://initd.org/pub/software/pysqlite/releases/1.1/1.1.6/pysqlite-1.1.6.win32-py2.3.exe">version </a><a href="http://initd.org/pub/software/pysqlite/releases/1.1/1.1.6/pysqlite-1.1.6.win32-py2.3.exe">1.1.6 release for python2.3.</a></li> <li><a href="http://initd.org/pub/software/pysqlite/releases/2.0/2.0.5/pysqlite-2.0.5.win32-py2.3.exe">version 2.0.5 for python2.3</a>. In that case, if you want to use a previous bibus database, you must update it by following <a href="pysqlite2.html">these instructions</a>.<br> </li> <ul> </ul> </ul> <li>If you want to use MySQL:</li> <ul> <li>MySQL from <a href="http://www.mysql.com">www.mysql.com</a>. The best is to use version <a href="http://downloads.mysql.com/archives/mysql-4.0/mysql-4.0.9-gamma-win.zip">4.0</a> or <a href="http://dev.mysql.com/downloads/mysql/4.1.html">4.1</a>.<br> </li> <ul> </ul> <li><a href="http://sourceforge.net/projects/mysql-python/">MySQL-python</a> for python2.3 from <http://sourceforge.net/projects/mysql-python>. The last version is 1.2.1c3 and is compatible with MySQL4.1. If you use a previous version, including 1.2.0, you must use MySQL up to 4.0. If you are planing to use MySQL4.1 (or 5.0), please <a href="mysql4.1_install.html">read this</a>.<br> </li> <ul> </ul> </ul> </ul> <ul> <li> <p>Download and execute bibus-1.1.1-Win32-Setup.exe from <a href="http://sourceforge.net/project/showfiles.php?group_id=110943">http://bibus-biblio.sourceforge.net/</a></p> </li> <ul> <li> <p><font color="#ff0000">Under Windows2000 and XP, you must start the installer as Administrator if you want to install bibus for all the users. Otherwise, bibus will be installed for the current user.</font><br> </p> </li> </ul> <li>Bibus must be the last installed software. If you update OpenOffice.org latter you may have to re-run the bibus installer.<br> </li> </ul> <h4><a class="mozTocH5" name="mozTocId769316"></a>With OpenOffice.org 1.1.x</h4> The Windows installer does not work with OpenOffice1.1.x. If you want to use this version, you must follow the old installation procedure.<br> <ul> <li> <p style="margin-bottom: 0cm;">Install OpenOffice.org from <a href="http://www.openoffice.org/">www.openoffice.org.</a> The current version is <a href="http://download.openoffice.org/1.1.5/index.html">1.1.5</a>.<br> </p> <ul> <li> <p style="margin-bottom: 0cm;">By default it should install in C:\Program Files\OpenOffice.org1.1.5\</p> </li> </ul> </li> <li> <p style="margin-bottom: 0cm;">Install <a href="http://www.python.org/ftp/python/2.2.3/Python-2.2.3.exe">python2.2.3</a> from www.python.org. <font color="#ff0000">Use 2.2.x version and not a more recent release since it will not work with OpenOffice.org.</font></p> <ul> <li> <p style="margin-bottom: 0cm;">By default it should install in C:\Program Files\Python22\ </p> </li> </ul> </li> <li> <p style="margin-bottom: 0cm;">Install <a href="http://prdownloads.sourceforge.net/wxpython/wxPythonWIN32-2.4.2.4u-Py22.exe?download">wxPython2.4.x</a> or <a href="http://prdownloads.sourceforge.net/wxpython/wxPython2.5-win32-unicode-2.5.3.1-py22.exe?download">wxPython2.5.x</a> from www.wxpython.org. Pay attention to get a version with unicode support and compiled for python2.2. </p> <ul> <li> <p style="margin-bottom: 0cm;"><a href="http://prdownloads.sourceforge.net/wxpython/wxPython2.5-win32-unicode-2.5.3.1-py22.exe?download">wxPython2.5-win32-unicode-2.5.3.1-py22.exe</a></p> </li> <li><a href="http://prdownloads.sourceforge.net/wxpython/wxPythonWIN32-2.4.2.4u-Py22.exe?download">wxPythonWIN32-2.4.2.4u</a><br> </li> </ul> </li> <li> <p style="margin-bottom: 0cm;">Depending on the database engine that you choose, download:</p> <ul> <li> <p style="margin-bottom: 0cm;">PySQLite for python2.2 from <http://pysqlite.org/> <a href="http://initd.org/pub/software/pysqlite/releases/1.1/1.1.6/pysqlite-1.1.6.win32-py2.2.exe">version 1.1.6 for python2.2</a></p> </li> <li>MySQL:</li> <ul> <li>MySQL from <a href="http://www.mysql.com">www.mysql.com</a>. The must use version <a href="http://downloads.mysql.com/archives/mysql-4.0/mysql-4.0.9-gamma-win.zip">4.0</a> or a previous one since the python-mysql package below is not compatible with a more recent release. </li> <li><a href="http://prdownloads.sourceforge.net/mysql-python/MySQL-python-0.9.2.win32-py2.2.exe?download">MySQL-python</a> for python2.2 from <http://sourceforge.net/projects/mysql-python>. <a href="http://prdownloads.sourceforge.net/mysql-python/MySQL-python-0.9.2.win32-py2.2.exe?download">version 0.9.2</a><br> </li> </ul> </ul> </li> <li> <p style="margin-bottom: 0cm;">Connect to your WindowsBox as Administrator </p> </li> </ul> <ul> <li>Download bibus-1.1.1.tgz from <a href="http://sourceforge.net/project/showfiles.php?group_id=110943">http://bibus-biblio.sourceforge.net/</a></li> <li>Uncompress the file<br> </li> <li> Follow the <a href="setup/introduction.html">setup process</a></li> </ul> <ul> <li> <p style="margin-bottom: 0cm;">You can of course make a shortcut on your desktop that points to bibusStart.pyw and eventually use one of the icons in <Bibus>/Pixmap.<br> </p> </li> </ul> <h3><a name="mozTocId425952"></a>GNU/Linux</h3> <h4><a class="mozTocH5" name="mozTocId157381"></a>Debian packages</h4> Starting with Bibus-1.0.0 you can install Bibus using apt-get. You should be able to use either OOo1.1.x or OOo2.0.<br> OOo2.0 has just been released in Debian unstable. For the moment you must donwload packages from the bibus site but I'm planing to make them available in the futur directly in Debian Unstable repository.<br> <ul> <li>Open /etc/apt/sources.list in a text editor</li> <li>Add the lines: <br> <pre>deb http://switch.dl.sourceforge.net/sourceforge/bibus-biblio ./<br>deb-src http://switch.dl.sourceforge.net/sourceforge/bibus-biblio ./</pre> </li> </ul> <pre style="margin-left: 40px;">(You can replace 'switch.dl.sourceforge.net' with the address of a Sourceforge mirror near you)</pre> <ul> <li> <pre>apt-get update</pre> </li> </ul> <h5><a class="mozTocH6" name="mozTocId44987"></a>Using OOo1.1.x<br> </h5> <ul> <li> <pre>apt-get install bibus bibus-doc-en openoffice-pyuno</pre> </li> </ul> <ul> <li>If you want to use SQLite:</li> <ul> <li> <pre>apt-get install libsqliteodbc python-pysqlite1.1</pre> </li> </ul> </ul> <blockquote>or you can use pysqlite2<br> </blockquote> <ul> <ul> <li> <pre>apt-get install libsqliteodbc python-pysqlite2</pre> </li> </ul> <ul> <li> <pre>In that case, if you want to use a previous bibus database, you must update it by following <a href="pysqlite2.html">these instructions</a></pre> </li> </ul> </ul> <ul> <li>If you want to use MySQL:</li> <ul> <li> <pre>apt-get install libmyodbc mysql-server mysql-common mysql-client python-mysqldb</pre> </li> </ul> <li>You can now start Bibus:<br> </li> <ul> <li>by typing 'bibus' in a terminal</li> <li>by choosing the bibus menu in Debian/Applications/Database/ <br> </li> </ul> <li> <p>To activate the Connection with OOo, click on <a href="setup/firsttime_1.html#firststartWizard">"Activate"</a> when you run Bibus for the first time.</p> </li> <li> <p>If you want to use the regular OOo interface to insert citations you still have to configure OOo as described in <a href="usingOOo.html#mozTocId871262">Using the regular OpenOffice.org interface</a></p> </li> </ul> <h5><a class="mozTocH6" name="mozTocId551738"></a>Using OOo2.0</h5> Openoffice.org2.0 is available in Debian unstable, you must thus run unstable to install bibus with OOo2.<br> There is a conflict between the old openoffice-pyuno package available with bibus1.0 and the new python-uno package available in Debian unstable. This conflict cannot be solved directly by apt or Synaptic.<br> <ul> <li>If you previously installed openoffice-pyuno:</li> <ul> <li> <pre>dpkg -r openoffice-pyuno</pre> </li> </ul> <li> <pre>apt-get install bibus bibus-doc-en</pre> </li> <li>If you want to use SQLite:</li> <ul> <li> <pre>apt-get install libsqliteodbc python-pysqlite1.1</pre> </li> </ul> </ul> <blockquote>or you can use pysqlite2<br> </blockquote> <ul> <ul> <li> <pre>apt-get install libsqliteodbc python-pysqlite2</pre> </li> <li> <pre>In that case, if you want to use a previous bibus database, you must update it by following <a href="pysqlite2.html">these instructions</a>.</pre> </li> </ul> </ul> <ul> <li>If you want to use MySQL:</li> <ul> <li> <pre>apt-get install libmyodbc mysql-server mysql-common mysql-client python-mysqldb</pre> </li> </ul> <li>You must install OpenOffice2 python the python-uno bridge</li> <ul> <li> <pre>apt-get install openoffice.org python-uno</pre> </li> </ul> <li>You can now start Bibus:<br> </li> <ul> <li>by typing 'bibus' in a terminal</li> <li>by choosing the bibus menu in Debian/Applications/Database/ <br> </li> </ul> <li> <p>To activate the Connection with OOo, click on <a href="setup/firsttime_1.html#firststartWizard">"Activate"</a> when you run Bibus for the first time.</p> </li> <li> <p>If you want to use the regular OOo interface to insert citations you still have to configure OOo as described in <a href="usingOOo.html#mozTocId871262">Using the regular OpenOffice.org interface</a></p> </li> </ul> <h4><a class="mozTocH5" name="mozTocId903848"></a>Other linux</h4> Most modern linux distribution now contain OpenOffice.org2 and a python-uno bridge compiled with the system python. This makes bibus installation much easier than before. If it is not the case of your distribution, you can still try to follow the <a href="introduction_old.html">old installation instructions.<br> </a>The name of the packages may be a bit different in your distribution but you should be able to guess the correct name. Install the following packages:<br> <ul> <li>openoffice2</li> <li>python-openoffice2</li> <li>python-sqlite</li> </ul> If you want also to use MySQL:<br> <ul> <li>mysql-server</li> <li>mysql-client</li> <li>python-mysql</li> </ul> Now Donwload bibus-1.1.1<br> <ul> <li>Connect as root<br> </li> <li>uncompress bibus-1.1.1 in /opt or any other place</li> <li>run:</li> <ul> <li>python /opt/bibus-1.1.1/Setup/setup.py</li> <li>Follow the instructions on the <a href="setup/introduction.html">screen</a></li> </ul> <li>You can of course make a shortcut on your desktop that points to bibusStart.pyw and eventually use one of the icons in <Bibus>/Pixmap.<br> <h2><a name="mozTocId42081"></a>Starting Bibus</h2> <p>If you want to use a MySQL database, you need to setup the database BEFORE starting Bibus the first time. It is very simple and is described in <a href="../../mysql_config.txt">mysql_config.txt.</a><br> If you want to use a SQLite database and if everything is installed on your machine, just start Bibus and follow the <a href="setup/firsttime_3.html">instructions on screen</a>. If you need more than one SQLite database you can:</p> </li> <li> <p style="margin-bottom: 0cm;">Re-run the wizard in the Help menu.</p> </li> <li> <p>Copy the database $BIBUS/Docs/db_models/biblio.sqlite (sqlite version 2) or biblio.sqlite3 (sqlite version 3) to your prefered location and use it (you can of course rename it).</p> </li> </ul> </body> </html>