8 Some distributions (Debian_ , Ubuntu_ , others?) package BE. If
9 you're running one of those distributions, you can install the package
10 with your regular package manager. For Debian, Ubuntu, and related
13 $ apt-get install bugs-everywhere
15 However, the official packages can lag behind current development.
17 If you're running Gentoo_, I've got a live ebuild in my overlay_ that
18 installs the current version of BE from the Git source.
20 Michel Alexandre Salim maintains a Fedora_ package.
22 .. _Debian: http://packages.debian.org/sid/bugs-everywhere
23 .. _Ubuntu: http://packages.ubuntu.com/lucid/bugs-everywhere
24 .. _Gentoo: http://www.gentoo.org/
25 .. _overlay: http://blog.tremily.us/posts/Gentoo_overlay/
26 .. _Fedora: https://admin.fedoraproject.org/pkgdb/acls/name/be
32 If your distribution does not package BE, you'll have to install it
33 yourself, along with its dependencies. Not all of these are strictly
34 required. See `Minimal installs`_ for possible shortcuts.
36 ============== ======================= ================ ===========================
37 Package Role Debian_ Gentoo_
38 ============== ======================= ================ ===========================
39 PyYAML_ upgrade old BE storage python-yaml dev-python/pyyaml
40 Jinja_ HTML templating python-jinja2 dev-python/jinja
41 CherryPy_ serve repos over HTTPS python-cherrypy3 dev-python/cherrypy
42 Sphinx_ see :doc:`doc` python-sphinx dev-python/sphinx
43 numpydoc_ see :doc:`doc` dev-python/numpydoc [#npd]_
44 Docutils_ manpage generation python-docutils dev-python/docutils
45 ============== ======================= ================ ===========================
47 .. [#npd] In the science_ overlay.
49 .. Debian has a stale ITP for python-numpydoc http://bugs.debian.org/631877
50 which caused BE to be dropped http://bugs.debian.org/609519
52 .. _PyYAML: http://pyyaml.org/
53 .. _Jinja: http://jinja.pocoo.org/
54 .. _CherryPy: http://cherrypy.org/
55 .. _Sphinx: http://sphinx.pocoo.org/
56 .. _numpydoc: http://pypi.python.org/pypi/numpydoc
57 .. _Docutils: http://docutils.sourceforge.net/
58 .. _science: http://overlays.gentoo.org/proj/science
63 BE is available as a Git repository::
65 $ git clone git://gitorious.org/be/be.git be
67 See the homepage_ for details. If you do branch the Git repo, you'll
72 to build some auto-generated files (e.g. :py:mod:`libbe._version`), and::
76 to install BE. By default BE will install into your home directory,
77 but you can tweak the ``INSTALL_OPTIONS`` variable in ``Makefile`` to
78 install to another location. With the default installation, you may
79 need to add ``~/.local/bin/`` to your ``PATH`` so that your shell can
80 find the installed ``be`` script.
85 By default, ``make`` builds both a man page for ``be`` and the HTML
86 Sphinx documentation (:doc:`doc`). You can customize the
87 documentation targets (if, for example, you don't want to install
88 Sphinx) by overriding_ the ``DOC`` variable. For example, to disable
89 all documentation during a build/install, run::
93 Note that ``setup.py`` (called during ``make install``) will install
94 the man page (``doc/man/be.1``) if it exists, so::
99 *will* build (first ``make``) and install (second ``make``) the man
102 Also note that there is no need to edit the ``Makefile`` to change any
103 of its internal variables. You can `override them from the command
104 line`__, as we did for ``DOC`` above.
108 Finally, if you want to do the absolute minimum required to install BE
109 locally, you can skip the ``Makefile`` entirely, and just use
110 ``setup.py`` directly::
112 $ python setup.py install
116 $ python setup.py install --help
118 for a list of installation options.
120 You only need YAML support if you will be upgrading a BE repository
121 based on ``Bugs Everywhere Directory v1.4`` or earlier (see
122 :file:`.be/version`). If you're installing a fresh instance of BE,
123 there's no need to install PyYAML. Jinja is only used by the ``html``
124 command, so there's no need to install Jinja if you don't mind
125 avoiding that command. Similarly, CherryPy is only used for the
126 ``html`` and ``serve-*`` commands with the ``--ssl`` option set. The
127 other dependencies are only used for :doc:`building these docs <doc>`,
128 so feel free to skip them and just use the docs wherever you're
129 currently reading them.
131 .. _homepage: http://bugseverywhere.org/
132 .. _overriding: http://www.gnu.org/software/make/manual/html_node/Overriding.html
138 For those not interested in the cutting edge, or those who don't want
139 to worry about installing Git, we'll `post release tarballs`_. After
140 you've downloaded the release tarball, unpack it with::
142 $ tar -xzvf be-<VERSION>.tar.gz
144 And install it with:::
149 .. _post release tarballs: http://download.bugseverywhere.org/releases/