Mercurial > p > roundup > code
diff doc/installation.txt @ 6739:00fe67eb8a91
Update locations templates and locale files are stored
Installing on a new ubuntu 22.04 venv at /tmp/roundup, I found the
locale and template files installed under
/tmp/roundup2/lib/python3.10/site-packages/usr/local/share which was
unexpected.
/tmp/roundup2/lib/python3.10/site-packages/tmp/roundup2/share would be
expected. Why sys.prefix (/tmp/roundup2) was not being used but
sys.base_prefix (/usr) and 'local' were added in I have no idea.
In any case, updated admin and i18n code to find the files in this
location.
Suggested building a venv for installation with commands in
installation.txt. Removed search for templates top level
directory. Was used for the old location of the tracker templates
pre-2009 when they were moved under share/roundup/templates.
left print statemts for debugging directory search in admin templates.
They are disabled by a variable set to False. At some point will add
pragma's to admin to set debugging and other options see issue
2551103.
| author | John Rouillard <rouilj@ieee.org> |
|---|---|
| date | Tue, 28 Jun 2022 23:16:47 -0400 |
| parents | 966263ad45ea |
| children | c27fc7f499c7 |
line wrap: on
line diff
--- a/doc/installation.txt Tue Jun 28 21:09:55 2022 -0400 +++ b/doc/installation.txt Tue Jun 28 23:16:47 2022 -0400 @@ -198,10 +198,25 @@ Basic Installation Steps ------------------------ -To install the Roundup support code into your Python tree and -Roundup scripts into /usr/bin (substitute that path for whatever is -appropriate on your system). You need to have write permissions -for these locations, eg. being root on unix:: +Installation of Roundup using Python3 in a virtual environment is +probably the path of least resistance. Use:: + + python3 -m venv /path/to/environment/roundup + +then proceed as below after activating (assuming a Bourne like shell) +the Python environment using:: + + . /path/to/environment/roundup/bin/activate + +then use the alias ``deactivate`` to return to the normal Python +environment. If you create the virtual envirnment as a non-root user, +you can install below using the same user. + +To install the Roundup support code into your Python tree and Roundup +scripts into /usr/bin (substitute that path for whatever is +appropriate on your system). You need to have write permissions for +these locations, so you may need to run wthese commands with ``sudo`` +if root permission is required:: python setup.py install