A fork of hyde, the static site generation. Some patches will be pushed upstream.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 

54 lines
2.1 KiB

  1. ============
  2. Installation
  3. ============
  4. Installing hyde is as simple as running the following command::
  5. python -m pip install hyde
  6. However, based on your choice and use of plugins you may need to install
  7. additional packages. The requirements for each plugin is outlined in the
  8. corresponding :doc:`plugins` documentation.
  9. Dependencies
  10. ============
  11. While your mileage may vary, we consider the following to be essential for
  12. generating a static website with Hyde. These are a part of the requirements
  13. file, and the above command will download and install all of them as part of
  14. Hyde.
  15. It is also recommended that you use `virtualenv <http://virtualenv.rtfd.org>`_
  16. to separate the Hyde environment from other python projects. Note that
  17. installing Hyde using ``pip`` would install all of the below. However, if you’d
  18. like finer grained control over the packages, you can install these
  19. individually:
  20. 1. ``argparse``: argparse is required if you are on python 2.6.
  21. 2. ``commando``: commando is a wrapper on top of argparse to give better syntax
  22. and support for multi-command applications.
  23. 3. ``Jinja2``: While Hyde will support many more template languages in the
  24. future, currently only Jinja2 is wholly supported and recommended.
  25. 4. ``Markdown``: While there are plans to add support for other markups
  26. (textile, restructured text, asciidoc etc..,), markdown is the one thats
  27. currently completely supported.
  28. 5. ``Pyyaml``: Much of Hyde’s :doc:`/configuration` is done using YAML.
  29. 6. ``pygments``: For syntax highlighting.
  30. 7. ``Typogrify``: Typogrify automatically fixes and enhances the typographical
  31. accuracy of your content. While this is not a technical requirement for
  32. Hyde, it is absolutely essential to create good looking content.
  33. The following commands can be used to install the dependencies for Hyde
  34. individually::
  35. python -m pip install argparse
  36. python -m pip install commando
  37. python -m pip install jinja2
  38. python -m pip install markdown
  39. python -m pip install pyyaml
  40. python -m pip install pygments
  41. python -m pip install smartypants
  42. python -m pip install typogrify