install.rst 1.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. .. Note
  2. Copyright 2017 Digital
  3. This file is part of BeeWatch.
  4. BeeWatch is free software: you can redistribute it and/or modify
  5. it under the terms of the GNU General Public License as published by
  6. the Free Software Foundation, either version 3 of the License, or
  7. (at your option) any later version.
  8. BeeWatch is distributed in the hope that it will be useful,
  9. but WITHOUT ANY WARRANTY; without even the implied warranty of
  10. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  11. GNU General Public License for more details.
  12. You should have received a copy of the GNU General Public License
  13. along with BeeWatch. If not, see <http://www.gnu.org/licenses/>.
  14. .. toctree::
  15. :maxdepth: 2
  16. :caption: Contents:
  17. Installation Guide for BeeWatch
  18. ===============================
  19. .. Warning:
  20. This program only supports GNU/Linux distros. It may work under another platform but I doubt that.
  21. You can install the module, build the documentation or do both (advised ;P). If you install the module after you have built the documentation, the documentation is copied to the folder of the installed module.
  22. Install BeeWatch
  23. ----------------
  24. To install BeeWatch run ``./setup.py install`` in BeeWatch-X.X. For more options run ``./setup.py help`` or see `Distributing on python.org <https://docs.python.org/3/distutils/index.html>`_
  25. Build the documentation
  26. -----------------------
  27. This project uses Sphinx for documentation generation. Sphinx can create the documentation in a variety of formats, eg html, pdf, epub an more. Run ``make help`` to get a list of supported file formats. Let's say you chose html, so you run ``make html``. This creates the documentation inside 'build/docs/<format>'. The entry point for reading the html version of the docs is `build/docs/html/index.html`.
  28. .. Todo::
  29. add requirements installation help
  30. ..