BibCiter
BibCiter (v1.2)

Scientific Bibliography Citer

Welcome

As many other free software projects, BibCiter was born — in Summer 2005 — to scratch an itch of mine. At first it was conceived to migrate a MS Access database to an open, online platform, share my bibliographic resources and have fun just doing it. Sharing not only my bibliographic resources but the tool itself seemed the logical next step. So here it is.

As a newby in the world of coding, I have learnt a lot from the WordPress community, so you'll easily find — beginning with styles and this readme file itself — some "inspiration" from them: my sincerest thanks and tribute.

— Ismael Peña-López

Installation

  1. Unzip the package in an empty directory
  2. Open up config.php with a text editor like WordPad or similar and fill in your database connection details, directory information and custom fields.
  3. Save the file
  4. Upload everything.
  5. Open install/index.php in your browser. This should ask you for the login and password for the main system administrator and, then, setup the tables needed for your BibCiter to run. If there is an error, double check your connection.php file, and try again.
  6. The install script should then run. You will be already logged in. Removing the install folder from the server is highly recommended.

Upgrading

Before you upgrade anything, make sure you have backup copies of all files and database data.

Upgrading from BibCiter v0.15 back to v0.14:

  1. Keep the "dress" folder
  2. Delete all other old BibCiter files, saving the ones you've modified appearing at the root of your installation (those should only be index.php and connection.php).
  3. Upload the new files
  4. Run install/upgrade_0.16.php in your browser. This will install a slight change to the "projects" table
  5. That's all.

Upgrading from BibCiter v0.14 back to v0.12:

  1. Keep the "dress" folder
  2. Delete all other old BibCiter files, saving the ones you've modified appearing at the root of your installation (those should only be index.php and connection.php).
  3. Upload the new files
  4. Run install/upgrade_0.15.php in your browser. This will install a slight change to the "bibliographies" table
  5. That's all.

Upgrading from BibCiter v0.11 back to v0.9.3:

  1. Keep the "dress" folder
  2. Delete all other old BibCiter files, saving the ones you've modified appearing at the root of your installation (those should only be index.php and connection.php).
  3. Add to your connection.php the lines 18 & 19 on the connection.php file in this package
  4. Upload the new files
  5. Run install/upgrade_0.12.php in your browser. This will install two new fields on the "projects" table
  6. That's all.

Upgrading from BibCiter v0.9.2.2 or older:

  1. Keep the "dress" folder
  2. Delete all other old BibCiter files, saving the ones you've modified appearing at the root of your installation (those should only be index.php and connection.php).
  3. Add to your connection.php file the lines 18 & 19 on the connection.php file in this package
  4. Upload the new files
  5. Run install/upgrade_0.9.3.php in your browser. This will install a lacking table on previous versions and newly created on v0.9.3 and the new fields created on v0.12
  6. That's all.

Template Changes

If you have customized your templates, they should still be running properly.

Online Resources

If you have any questions that aren't addressed in this document, please visit BibCiter's online resources:

The BibCiter Codex
The Codex is the online handbook of BibCiter.
The Development Blog
This is where you'll find the latest updates and news related to BibCiter.

System Recommendations

Copyright

BibCiter is released under the GPL (see license.txt).