Skip to content

Latest commit

 

History

History
executable file
·
78 lines (40 loc) · 2.35 KB

README.md

File metadata and controls

executable file
·
78 lines (40 loc) · 2.35 KB
Raw

Fidus Writer

Fidus Writer is an online collaborative editor especially made for academics who need to use citations and/or formulas. The editor focuses on the content rather than the layout, so that with the same text, you can later on publish it in multiple ways: On a website, as a printed book, or as an ebook. In each case, you can choose from a number of layouts that are adequate for the medium of choice.

Contributing

For details on contributing, please check http://fiduswriter.com/help-us/

License

All of Fidus Writer's original code is licensed under the GNU AFFERO GENERAL PUBLIC LICENSE, for details see LICENSE. Some third party libraries are licensed under other, compatible open source libraries. Licensing information is included in those files.

Howto install

The following are instructions working on most *NIX systems.

  1. Install the development package of libjpeg. How you do this depends on your system. On Ubuntu the package is called libjpeg-dev. Install with your favorite package manager.

  2. Start the command line (terminal).

  3. Cd to where you have your sources.

  4. Install virtualenv. To do so, type on the command line:

easy_install virtualenv

  1. Once virtualenv is installed, you can use the virtualenv command to create virtual environments. The following command will create an environment called "fiduswriter-venv":

virtualenv --no-site-packages fiduswriter-venv

  1. Activate the virtualenv by typing:

source fiduswriter-venv/bin/activate

  1. Install the requirements for running fiduswriter by typing:

pip install -r requirements.txt

  1. Synchronize the DB and create a superuser by typing:

python manage.py syncdb

python manage.py migrate

python manage.py loaddata bibliography/fixture/initial_bib_rules.json

  1. Run the fiduswriter server by typing:

python manage.py runserver

  1. Navigate to "http://localhost:8000/admin/socialaccount/socialapp/add/"

  2. Add at least one social app for Facebook. If you do not have actual Facebook app credentials, use the following data and save:

Provider: Facebook

Name: Facebook

Client id: 1

Secret: 1

Sites: example.com

For best results for the end user:

  1. Install Chrome/Chromium at least version 26

  2. Enable Webkit experimental features (in type "about:flags" into the navigation bar of the browser)

  3. Restart Chrome/Chromium