PhpBibliography Git
Brought to you by:
lbettini
Menu
▾
▴
Tree [18a1db] master rel_1.1.1 / History
Lorenzo Bettini
Lorenzo Bettini
Read Me
PhpBibliography - web based bibliography system
* SF - Page <http://sourceforge.net/projects/phpbibliography>
* Downloads <http://sourceforge.net/projects/phpbibliography/files/>
* Install <#Installation>
* Features <#Features>
* Git <http://phpbibliography.git.sourceforge.net/>
by Lorenzo Bettini <http://www.lorenzobettini.it/>
PhpBibliography allows you to publish your bibliography online (and to
edit it via web).
It is implemented in Php 5 and uses MySql 5 (however, it might work also
with Php 4, and also with MySql 4, but I'm not testing this).
This is a complete rewriting using CakePhp <http://www.cakephp.org/>,
the old version site is available here
<http://phpbibliography.sourceforge.net/phpbibliography-old/>.
It can also generate RSS feeds and import papers from DBLP
<http://www.informatik.uni-trier.de/%7Eley/db/index.html>, thanks to
Ezio Bartocci <http://www.eziobartocci.com/>.
This is free software, open source, released under GPL <COPYING>.
Download
You can download PhpBibliography from here:
http://sourceforge.net/projects/phpbibliography
You need a web server with php support and a MySql server. In
particular, phpbibliography was developed under Linux, using Apache 2
web server (I guess it should work also on other systems).
You can also find details about new features on my blog, in this area:
http://tronprog.blogspot.com/search/label/phpbibliography.
Installation
These instructions assume you already have a working web
server/php/MySql system.
If you have an already installed version of PhpBibliography (earlier
than version 1.x) you will need to follow the instructions you find at
this link
<http://phpbibliography.sourceforge.net/phpbibliography-old/upgrade_to_1.html>.
As an example, we will assume to install phpbibliography in the
directory phpbibliography and to access it through localhost.
1. Create a database called phpbibliography (this is the default but
you can choose the name you want; for instance some providers
already set up some databases for you, with predefined names) and
assign user and password to the created database (or use the ones
set by your provider).
2. Unzip the contents of the archive in a directory of your web server.
3. PhpBibliography assumes that your apache web server has the
mod_rewrite module installed and working; PhpBibliography relies
on CakePhp <http://www.cakephp.org/>, thus you can find further
installation advanced instructions (especially concerning
mod_rewrite) in the official CakePhp documentation
<http://book.cakephp.org/view/32/Installation>, in particular, see
the section about mod_rewrite
<http://book.cakephp.org/view/37/Apache-and-mod_rewrite-and-htaccess>.
4. Make sure that the directories app/config, app/webroot/files and
app/tmp are writable by the web server user (you can also make
them writable by anyone, e.g., with chmod 777). After the
installation successfully finished, you can also make app/config
directory not writable anymore.
5. Now visit the subdirectory installs with a browser of the site
where you installed phpbibliography (e.g., in our example
http://localhost/phpbibliography/installs); if everything was set
up correctly you should see something like the following screenshot
installation screenshot
6. Now provide the information concerning your database you created
and press submit (the table prefix is useful if your provider
gives only one database that you need to share with other web
software)
7. Check that everything works; you can now go back to the database
configuration, or proceed with the installation.
8. The next step will create the database tables and you can simply
press the Create button.
9. Then you can finalize the installation (press Finalize button).
10. You should get the message that PhpBibliography is now correctly
installed (note that visiting the installs path again will not be
allowed) and that you can now login.
11. Phpbibliography comes with a predefined admin user, password
admin. Use it to login the first time and then go in the users
section and change the password.
While logged as a user you can add/edit/remove papers and other
information concerning the papers.
The public phpbibliography interface is accessible now through the path
where you installed phpbibliography (in our example,
http://localhost/phpbibliography).
If you need to login again you can do that using the login path (in our
example, http://localhost/phpbibliography/login).
Adding and modifying users and papers
Online help is available when editing/adding papers; please refer to
that help for further details.
You can create further users if you want; if you set the "admin" check
box when creating/editing a user, that user will have administration
privileges (e.g., he'll be able to change other users besides himself).
Next you can start adding your authors, attributes for the papers, and
then the papers themselves. This can be done by accessing the admin menu.
When inserting a paper you can also upload two files for your paper
(they will be uploaded in the files subdirectory, see above); you can
also insert a direct link (URL) to the paper if the paper is already
available on-line somewhere else.
Features
These are the main features provided by PhpBibliography:
* Automatic generation of bibtex for papers (unless a manual bib
item is specified when editing the paper).
* For each paper two files can be uploaded and two links can be
specified.
* Papers can be searched with criteria about their fields.
* Besides standard fields, new attributes can be specified for
papers; attributes can be selectable, i.e., the logged user can
choose among a(n extensible) set of values and multiple, i.e., a
paper can be given several values for that attribute; an example
of selectable/single attribute is "Publisher", an example of
selectable/multiple attribute is "Keyword", and an example of
non-selectable attribute is "DOI".
* Papers can be specified as private (visible only to logged users).
* Reports can be generated by filtering by author, by value and by
grouping up to two levels (e.g., show only papers of a given
authors, grouped by year and by paper type).
* RSS feeds are available for search results, reports and paper lists.
* Lists of papers, and results of reports and searches can be
included in other webpages (by using the bare layout).
* Papers can be imported from DBLP
<http://www.informatik.uni-trier.de/%7Eley/db/index.html>.
* Searches for possible duplicate papers.
* Papers can be inserted through bibtex items and bibtex files.
Other Links
* Install PhpBibliography in Ubuntu
<https://sourceforge.net/apps/mediawiki/phpbibliography/index.php?title=Help:Install_PhpBibliography_in_Ubuntu>.
News :
*May 2010*: release 1.0.0:
Complete rewriting using CakePhp framework.
Links :
* Wiki
<https://sourceforge.net/apps/mediawiki/phpbibliography/index.php?title=Main_Page>
* Forums <https://sourceforge.net/projects/phpbibliography/forums>
* Blog <http://tronprog.blogspot.com/search/label/phpbibliography>
* Bugs <http://sourceforge.net/tracker/?group_id=166172&atid=837962>
Screenshots :
Installation Screenshot
Installation screenshot
Get PhpBibliography at SourceForge.net. Fast, secure and Free Open
Source software downloads <http://sourceforge.net/projects/phpbibliography>
Site by Lorenzo Bettini <http://www.lorenzobettini.it>
Design by Minimalistic Design <http://www.minimalistic-design.net>
