Self hosted FLOSS fitness/workout, nutrition and weight tracker
Remove docs folder, was extracted to own repo
Roland Geider4d2d618db1db
diff --git a/README.md b/README.mdindex 0d66a5b66..58af95280 100644--- a/README.md+++ b/README.md@@ -24,8 +24,8 @@ For a live system, refer to the project's site: <https://wger.de/>These are the basic steps to install and run the application locally on a Linuxsystem. There are more detailed instructions, other deployment options as well-as an administration guide available at <https://wger.readthedocs.io> or locally-in your code repository in the docs folder.+as an administration guide available at <https://wger.readthedocs.io> or in the+[docs repo](https://github.com/wger-project/docs).Please consult the commands' help for further information and availableparameters.diff --git a/docs/Makefile b/docs/Makefiledeleted file mode 100644index dc20f0830..000000000--- a/docs/Makefile+++ /dev/null@@ -1,177 +0,0 @@-# Makefile for Sphinx documentation-#--# You can set these variables from the command line.-SPHINXOPTS =-SPHINXBUILD = sphinx-build-PAPER =-BUILDDIR = _build--# User-friendly check for sphinx-build-ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)-$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)-endif--# Internal variables.-PAPEROPT_a4 = -D latex_paper_size=a4-PAPEROPT_letter = -D latex_paper_size=letter-ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .-# the i18n builder cannot share the environment and doctrees with the others-I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .--.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext--help:- @echo "Please use \`make <target>' where <target> is one of"- @echo " html to make standalone HTML files"- @echo " dirhtml to make HTML files named index.html in directories"- @echo " singlehtml to make a single large HTML file"- @echo " pickle to make pickle files"- @echo " json to make JSON files"- @echo " htmlhelp to make HTML files and a HTML help project"- @echo " qthelp to make HTML files and a qthelp project"- @echo " devhelp to make HTML files and a Devhelp project"- @echo " epub to make an epub"- @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"- @echo " latexpdf to make LaTeX files and run them through pdflatex"- @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx"- @echo " text to make text files"- @echo " man to make manual pages"- @echo " texinfo to make Texinfo files"- @echo " info to make Texinfo files and run them through makeinfo"- @echo " gettext to make PO message catalogs"- @echo " changes to make an overview of all changed/added/deprecated items"- @echo " xml to make Docutils-native XML files"- @echo " pseudoxml to make pseudoxml-XML files for display purposes"- @echo " linkcheck to check all external links for integrity"- @echo " doctest to run all doctests embedded in the documentation (if enabled)"--clean:- rm -rf $(BUILDDIR)/*--html:- $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html- @echo- @echo "Build finished. The HTML pages are in $(BUILDDIR)/html."--dirhtml:- $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml- @echo- @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."--singlehtml:- $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml- @echo- @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."--pickle:- $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle- @echo- @echo "Build finished; now you can process the pickle files."--json:- $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json- @echo- @echo "Build finished; now you can process the JSON files."--htmlhelp:- $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp- @echo- @echo "Build finished; now you can run HTML Help Workshop with the" \- ".hhp project file in $(BUILDDIR)/htmlhelp."--qthelp:- $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp- @echo- @echo "Build finished; now you can run "qcollectiongenerator" with the" \- ".qhcp project file in $(BUILDDIR)/qthelp, like this:"- @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/wgerWorkoutManager.qhcp"- @echo "To view the help file:"- @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/wgerWorkoutManager.qhc"--devhelp:- $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp- @echo- @echo "Build finished."- @echo "To view the help file:"- @echo "# mkdir -p $$HOME/.local/share/devhelp/wgerWorkoutManager"- @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/wgerWorkoutManager"- @echo "# devhelp"--epub:- $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub- @echo- @echo "Build finished. The epub file is in $(BUILDDIR)/epub."--latex:- $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex- @echo- @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."- @echo "Run \`make' in that directory to run these through (pdf)latex" \- "(use \`make latexpdf' here to do that automatically)."--latexpdf:- $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex- @echo "Running LaTeX files through pdflatex..."- $(MAKE) -C $(BUILDDIR)/latex all-pdf- @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."--latexpdfja:- $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex- @echo "Running LaTeX files through platex and dvipdfmx..."- $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja- @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."--text:- $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text- @echo- @echo "Build finished. The text files are in $(BUILDDIR)/text."--man:- $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man- @echo- @echo "Build finished. The manual pages are in $(BUILDDIR)/man."--texinfo:- $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo- @echo- @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."- @echo "Run \`make' in that directory to run these through makeinfo" \- "(use \`make info' here to do that automatically)."--info:- $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo- @echo "Running Texinfo files through makeinfo..."- make -C $(BUILDDIR)/texinfo info- @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."--gettext:- $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale- @echo- @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."--changes:- $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes- @echo- @echo "The overview file is in $(BUILDDIR)/changes."--linkcheck:- $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck- @echo- @echo "Link check complete; look for any errors in the above output " \- "or in $(BUILDDIR)/linkcheck/output.txt."--doctest:- $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest- @echo "Testing of doctests in the sources finished, look at the " \- "results in $(BUILDDIR)/doctest/output.txt."--xml:- $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml- @echo- @echo "Build finished. The XML files are in $(BUILDDIR)/xml."--pseudoxml:- $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml- @echo- @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."diff --git a/docs/changelog.rst b/docs/changelog.rstdeleted file mode 100644index 59463b303..000000000--- a/docs/changelog.rst+++ /dev/null@@ -1,702 +0,0 @@-Changelog-=========--2.1 - IN DEVELOPMENT----------------------**2021-XX-XX**--Upgrade steps from 2.0:--* Update python libraries ``pip3 install -r requirements.txt``-* Run migrations ``python3 manage.py migrate``-* Update CSS and JS libraries ``yarn install``-* Compile the CSS ``yarn build:css:sass``-* Update static files (only production): ``python3 manage.py collectstatic``--🚀 Features:--* New gallery where users can upload pictures to track their progress `#572`_-* Add templates / centrally managed workouts (thanks `@qwert45hi`_) `#639`_-* Add comment filed to set for user notes `#702`_-* Custom measurements such as biceps size or body fat `#133`_-* Add picture type to exercise images (thanks `@LucasSD`_) `#589`_-* Add toptional relation from nutritional diary to meal (thanks `@Alig1493`_) `#819`_--🐛 Bug Fixes:--* ...--🧰 Maintenance:--* Changes to the REST API:-- + /exerciseimage/- - ``exercise`` was renamed to ``exercise_base`` (was pointing there anyway)- - New field ``style``- + /workout/- - ``comment`` was renamed to name- - field ``description`` was added, for longer descriptions- + /set/- - field ``comment`` added, for user notes- + /nutritiondiary/- - field ``meal`` added, optional reference to meal- + /min-app-version/- - New endpoint indicating minimum required version for flutter app-* `#666`_, `#667`_, `#656`_ (thanks `@jackmulligan-ire`_), `#716`_--.. _#133: https://github.com/wger-project/wger/issues/133-.. _#572: https://github.com/wger-project/wger/issues/572-.. _#589: https://github.com/wger-project/wger/issues/589-.. _#639: https://github.com/wger-project/wger/issues/639-.. _#656: https://github.com/wger-project/wger/issues/656-.. _#666: https://github.com/wger-project/wger/issues/666-.. _#667: https://github.com/wger-project/wger/issues/667-.. _#702: https://github.com/wger-project/wger/issues/702-.. _#716: https://github.com/wger-project/wger/issues/716-.. _#819: https://github.com/wger-project/wger/issues/819--.. _@Alig1493: https://github.com/Alig1493-.. _@LucasSD: https://github.com/LucasSD-.. _@qwert45hi: https://github.com/qwert45hi-.. _@jackmulligan-ire: https://github.com/jackmulligan-ire---2.0----------------------**2021-05-01**--Upgrade steps from 1.9:--* Update python libraries ``pip3 install -r requirements.txt``-* Install ``yarn`` and ``sass`` (e.g. ``sudo npm install -g yarn sass``)-* Update CSS and JS libraries ``yarn install``-* Compile the CSS ``yarn build:css:sass``-* Run migrations ``python3 manage.py migrate``-* Update data ``python3 manage.py loaddata licenses.json languages.json language_config.json``-* Load new ingredients (note that this will overwrite any ingredients that you- might have added) ``wger load-online-fixtures``-* Update static files (only production): ``python3 manage.py collectstatic``-* Subcommands for ``wger`` now use dashes in their names (i.e. create-settings- instead of create_settings)---🚀 Features:--* Add nutrition diary to log the daily calories actually taken `#284`_, `#501`_- and `#506`_ (thanks `@WalkingPizza`_ and `@oconnelc`_)-* Support for reps-in-reserve (RiR) in workout plans and logs `#479`_- (thanks `@SkyNetIndustry`_)-* Improved user experience, on desktop and mobile `#337`_-* Around 70000 new ingredients with Open Food Facts import with more to come `#422`_- (thanks `@harlenesamra`_, `@nikithamurikinati`_ and `@jcho1`_)-* Group common exercise information such as muscles, etc. for more easy translations,- data management, etc. `#448`_ (thanks `@nikithamurikinati`_, `@harlenesamra`_,- `@jcho17`_, `@vaheeshta`_ and `@jeevikaghosh`_)-* Group similar exercises such as wide grip, reverse, etc. `#555`_- (thanks `@ryowright`_)-* Improved info endpoints for exercises and ingredients, this saves additional- API calls `#411`_-* Show BMI on weight graph `#462`_ (thanks `@Svn-Sp`_)-* Allow user to edit and delete body weight entries `#478`_ (thanks `@beingbiplov`_)-* Show kJoules as well as kcal in nutritional plan `#568`_ (thanks `@nopinter`_ and `@derekli17`_)-* Check name similarity when adding exercises to avoid duplicates `#551`_- (thanks `@lydiaxing`_, `@eq8913`_, `@Hita-K`_)-* Return the muscle background images in the REST API `#547`_ (thanks `@gengkev`_)---🐛 Bug Fixes:--* `#368`_, `#379`_, `#426`_ (thanks `@austin-leung`_), `#499`_, `#505`_, `#504`_,- `#511`_, `#516`_, `#522`_, `#554`_ and `#560`_ (thanks `@sandilsranasinghe`_),- `#564`_, `#565`_, `#615`_, `#560`_ (thanks `@bradsk88`_), `#617`_ (thanks `@Sidrah-Madiha`_),- `#636`_, `#640`_, `#642`_, `#648`_, `#650`_---🧰 Maintenance:--* Moved translations to weblate `#266`_-* Improved docker and docker-compose images `#340`_-* Updated many libraries to the last version (bootstrap, font awesome, etc.)-* Use yarn to download CSS/JS libraries-* Improvements to documentation (e.g. `#494`_)-* Improved cache handling `#246`_ (thanks `@louiCoder`_)-* Others: `#450`_ (thanks `@Rkamath2`_), `#631`_ (thanks `@harlenesamra`_), `#664`_ (thanks `@calvinrw`_),--.. _@Svn-Sp: https://github.com/Svn-Sp-.. _@louiCoder: https://github.com/louiCoder-.. _@WalkingPizza: https://github.com/WalkingPizza-.. _@oconnelc: https://github.com/oconnelc-.. _@beingbiplov: https://github.com/beingbiplov-.. _@sandilsranasinghe: https://github.com/sandilsranasinghe-.. _@Rkamath2: https://github.com/Rkamath2-.. _@SkyNetIndustry: https://github.com/SkyNetIndustry-.. _@ryowright: https://github.com/ryowright-.. _@austin-leung: https://github.com/austin-leung-.. _@harlenesamra: https://github.com/harlenesamra-.. _@lydiaxing: https://github.com/lydiaxing-.. _@eq8913: https://github.com/eq8913-.. _@Hita-K: https://github.com/Hita-K-.. _@derekli17: https://github.com/derekli17-.. _@nopinter: https://github.com/nopinter-.. _@gengkev: https://github.com/gengkev-.. _@nikithamurikinati: https://github.com/nikithamurikinati-.. _@jcho1: https://github.com/jcho1-.. _@jcho17: https://github.com/jcho17-.. _@vaheeshta: https://github.com/vaheeshta-.. _@jeevikaghosh: https://github.com/jeevikaghosh-.. _@bradsk88: https://github.com/bradsk88-.. _@Sidrah-Madiha: https://github.com/Sidrah-Madiha-.. _@calvinrw: https://github.com/calvinrw---.. _#246: https://github.com/wger-project/wger/issues/246-.. _#266: https://github.com/wger-project/wger/issues/266-.. _#284: https://github.com/wger-project/wger/issues/284-.. _#337: https://github.com/wger-project/wger/issues/337-.. _#340: https://github.com/wger-project/wger/issues/340-.. _#368: https://github.com/wger-project/wger/issues/368-.. _#379: https://github.com/wger-project/wger/issues/379-.. _#411: https://github.com/wger-project/wger/issues/411-.. _#422: https://github.com/wger-project/wger/issues/422-.. _#426: https://github.com/wger-project/wger/issues/426-.. _#448: https://github.com/wger-project/wger/issues/448-.. _#450: https://github.com/wger-project/wger/issues/450-.. _#462: https://github.com/wger-project/wger/issues/462-.. _#478: https://github.com/wger-project/wger/issues/478-.. _#479: https://github.com/wger-project/wger/issues/479-.. _#494: https://github.com/wger-project/wger/issues/494-.. _#499: https://github.com/wger-project/wger/issues/499-.. _#501: https://github.com/wger-project/wger/issues/501-.. _#504: https://github.com/wger-project/wger/issues/504-.. _#505: https://github.com/wger-project/wger/issues/505-.. _#506: https://github.com/wger-project/wger/issues/506-.. _#511: https://github.com/wger-project/wger/issues/511-.. _#516: https://github.com/wger-project/wger/issues/516-.. _#522: https://github.com/wger-project/wger/issues/522-.. _#547: https://github.com/wger-project/wger/issues/547-.. _#550: https://github.com/wger-project/wger/issues/550-.. _#551: https://github.com/wger-project/wger/issues/551-.. _#554: https://github.com/wger-project/wger/issues/554-.. _#555: https://github.com/wger-project/wger/issues/555-.. _#560: https://github.com/wger-project/wger/issues/560-.. _#564: https://github.com/wger-project/wger/issues/564-.. _#565: https://github.com/wger-project/wger/issues/565-.. _#568: https://github.com/wger-project/wger/issues/568-.. _#615: https://github.com/wger-project/wger/issues/615-.. _#617: https://github.com/wger-project/wger/issues/617-.. _#631: https://github.com/wger-project/wger/issues/631-.. _#636: https://github.com/wger-project/wger/issues/636-.. _#640: https://github.com/wger-project/wger/issues/640-.. _#642: https://github.com/wger-project/wger/issues/642-.. _#648: https://github.com/wger-project/wger/issues/648-.. _#650: https://github.com/wger-project/wger/issues/650-.. _#664: https://github.com/wger-project/wger/issues/664----1.9-----**2020-06-29**--Upgrade steps from 1.8:--* Django update to 3.x: ``pip install -r requirements.txt``-* Database upgrade: ``python manage.py migrate``-* Update static files (only production): ``python manage.py collectstatic``--New features:--* Allow users to enter their birthdate instead of just the age (thanks `@dtopal`_) `#332`_-* Work to ensure that mobile templates are used when appropriate-* Added optional S3 static asset hosting.-* Drop Python 2 support.-* Replaced django-mobile with django-user_agent (and some custom code)- This isn't as slick as django-mobile was, but it unblocks possible Django 2.x support.-* Update many dependencies to current versions.--Improvements:--* Improve the look of weight graph (thanks `@alokhan`_) `#381`_-* Added password validation rules for more security-* Exercise image downloader checks only accepted exercises (thanks `@gmmoraes`_) `#363`_-* Use a native data type for the exercises' UUID (thanks `@gmmoraes`_) `#364`_-* Increase speed of testsuite by performing the tests in parallel (thanks `@Mbarak-Mbigo`_) `wger_vulcan/#6`_-* Update screen when adding an exercise to the workout while using set slider (thanks `@gmmoraes`_) `#374`_-* Work to slim docker image- * Download images at startup - If `DOWNLOAD_IMGS` environmental variable is set to `TRUE`- * Uninstall dev packages-* Update Ubuntu version used in docker container.-* Fixed a handful of hard coded static path references to use `static` taglib-* Updated tinymce theme for v5.--Other improvements and bugfixes: `#336`_, `#359`_,`#386`_, `#443`_--.. _@gmmoraes: https://github.com/gmmoraes-.. _@Mbarak-Mbigo: https://github.com/Mbarak-Mbigo-.. _@dtopal: https://github.com/dtopal--.. _wger_vulcan/#6: https://github.com/andela/wger_vulcan/pull/6--.. _#332: https://github.com/wger-project/wger/issues/332-.. _#336: https://github.com/wger-project/wger/issues/336-.. _#359: https://github.com/wger-project/wger/issues/359-.. _#363: https://github.com/wger-project/wger/issues/363-.. _#364: https://github.com/wger-project/wger/issues/364-.. _#374: https://github.com/wger-project/wger/issues/374-.. _#381: https://github.com/wger-project/wger/issues/381-.. _#386: https://github.com/wger-project/wger/issues/386-.. _#443: https://github.com/wger-project/wger/issues/443---1.8-----**2017-04-05**--.. warning ::- There have been some changes to the installation procedure. Calling 'invoke'- on its own has been deprecated, you should use the 'wger' command (which- accepts the same options). Also, some of these commands have been renamed:-- * ``start_wger`` to ``wger``- * ``bootstrap_wger`` to ``bootstrap``--Upgrade steps from 1.7:--* Django update to 1.9: ``pip install -r requirements.txt``-* Database upgrade: ``python manage.py migrate``-* Reset cache: ``python manage.py clear-cache --clear-all``-* Due to changes in the JS package management, you have to delete- wger/core/static/bower_components and do a ``python manage.py bower install``-* Update static files (only production): ``python manage.py collectstatic``-* Load new the languages fixtures as well as their configuration- ``python manage.py loaddata languages`` and- ``python manage.py loaddata language_config``-* New config option in settings.py: ``WGER_SETTINGS['TWITTER']``. Set this if- your instance has its own twitter account.--New languages:--* Norwegian (many thanks to Kjetil Elde `@w00p`_ `#304`_)-* French (many thanks to all translators)--New features:--* Big ingredient list in Dutch, many thanks to alphafitness.club!-* Add repetition (minutes, kilometer, etc.) and weight options (kg, lb, plates, until failure) to sets `#216`_ and `#217`_-* Allow administrators to deactivate the guest user account `#330`_-* Add option to show the gym name in the header instead of the application name, part of `#214`_-* Exercise names are now capitalized, making them more consistent `#232`_-* Much improved landing page (thanks `@DeveloperMal`_) `#307`_-* Add extended PDF options to schedules as well (thanks `@alelevinas`_ ) `#272`_-* Show trained secondary muscles in workout view (thanks `@alokhan`_ ) `#282`_-* Use the metricsgraphics library to more easily draw charts `#188`_-* Removed persona (browserID) as a login option, the service is being discontinued `#331`_--Improvements:--* Check and enforce style guide for JS files `#317`_ (`@petervanderdoes`_)-* BMI calculator now works with pounds as well (thanks `@petervanderdoes`_) `#318`_-* Give feedback when autocompleter didn't find any results `#293`_-* Make exercise names links to their detail page in training log pages `#350`_-* Better GUI consistency in modal dialogs (thanks `@jstoebel`_ ) `#274`_-* Cache is cleared when editing muscles (thanks `@RyanSept`_ `@pythonGeek`_ ) `#260`_-* Fields in workout log form are no longer required, making it possible to only log weight for certain exercises `#334`_-* New, more verbose, API endpoint for exercises, (thanks `@andela-bmwenda`_)-* The dashboard page was improved and made more user friendly `#201`_ (partly)-* Replace jquery UI's autocompleter and sortable this reduces the size of JS and CSS `#78`_ and `#79`_-* Update to D3js v4 `#314`_, `#302`_-* Remove hard-coded CC licence from documentation and website `#247`_--Other improvements and bugfixes: `#25`_, `#243`_, `#279`_, `#275`_, `#270`_,-`#258`_, `#257`_, `#263`_, `#269`_, `#296`_, `#297`_, `#303`_, `#311`_, `#312`_,-`#313`_, `#322`_, `#324`_, `#325`_---.. _#25: https://github.com/wger-project/wger/issues/25-.. _#78: https://github.com/wger-project/wger/issues/78-.. _#79: https://github.com/wger-project/wger/issues/79-.. _#188: https://github.com/wger-project/wger/issues/188-.. _#201: https://github.com/wger-project/wger/issues/201-.. _#214: https://github.com/wger-project/wger/issues/214-.. _#216: https://github.com/wger-project/wger/issues/216-.. _#217: https://github.com/wger-project/wger/issues/217-.. _#232: https://github.com/wger-project/wger/issues/232-.. _#243: https://github.com/wger-project/wger/issues/243-.. _#248: https://github.com/wger-project/wger/issues/248-.. _#247: https://github.com/wger-project/wger/issues/247-.. _#260: https://github.com/wger-project/wger/issues/260-.. _#263: https://github.com/wger-project/wger/issues/263-.. _#269: https://github.com/wger-project/wger/issues/269-.. _#272: https://github.com/wger-project/wger/issues/272-.. _#274: https://github.com/wger-project/wger/issues/274-.. _#282: https://github.com/wger-project/wger/issues/282-.. _#293: https://github.com/wger-project/wger/issues/293-.. _#296: https://github.com/wger-project/wger/issues/296-.. _#297: https://github.com/wger-project/wger/issues/297-.. _#302: https://github.com/wger-project/wger/issues/302-.. _#303: https://github.com/wger-project/wger/issues/303-.. _#304: https://github.com/wger-project/wger/issues/304-.. _#307: https://github.com/wger-project/wger/issues/307-.. _#311: https://github.com/wger-project/wger/issues/311-.. _#312: https://github.com/wger-project/wger/issues/312-.. _#313: https://github.com/wger-project/wger/issues/313-.. _#314: https://github.com/wger-project/wger/issues/314-.. _#317: https://github.com/wger-project/wger/issues/317-.. _#318: https://github.com/wger-project/wger/issues/318-.. _#322: https://github.com/wger-project/wger/issues/322-.. _#324: https://github.com/wger-project/wger/issues/324-.. _#325: https://github.com/wger-project/wger/issues/325-.. _#330: https://github.com/wger-project/wger/issues/330-.. _#331: https://github.com/wger-project/wger/issues/331-.. _#334: https://github.com/wger-project/wger/issues/334-.. _#350: https://github.com/wger-project/wger/issues/350-.. _@petervanderdoes: https://github.com/petervanderdoes-.. _@DeveloperMal: https://github.com/DeveloperMal-.. _@alelevinas: https://github.com/alelevinas-.. _@jstoebel: https://github.com/jstoebel-.. _@alokhan: https://github.com/alokhan-.. _@w00p: https://github.com/w00p-.. _@andela-bmwenda: https://github.com/andela-bmwenda-.. _@RyanSept: https://github.com/RyanSept-.. _@pythonGeek: https://github.com/pythonGeek----1.7-----**2016-02-28**--New translations:--* Czech (many thanks to Tomáš Z.!)-* Swedish (many thanks to ywecur!)---New features:--* Workout PDF can now print the exercises' images and comments `#261`_-* Allow login with username or email (thanks `@warchildmd`_) #164`_-* Correctly use user weight when calculating nutritional plans' calories (thanks `@r-hughes`_) `#210`_-* Fix problem with datepicker `#192`_-* Order of exercises in supersets is not reverted anymore `#229`_-* Improvements to the gym management:-- * Allow to add contracts to members- * Visual consistency for lists and actions- * Vastly reduce the number of database queries in gym member list `#144`_- * Global list of users for installation `#212`_- * Allow administrators to restrict user registration `#220`_- * Refactored and improved code, among others `#208`_- * Allow gym managers to reset a member's password `#186`_--* Better rendering of some form elements `#244`_-* Improved GUI consistency `#149`_-* Docker images for easier installation `#181`_-* Use hostname for submitted exercises (thanks `@jamessimas`_) `#159`_-* Download js libraries with bowerjs (thanks `@tranbenny`_) `#126`_-* Improved and more flexible management commands `#184`_-* Fixed error when importin weight entries from CSV (thanks `@r-hughes`_) `#204`_-* Fixed problems when building and installing the application on Windows (thanks `@romansp`_) `#197`_-* Fixed potential Denial Of Service attack (thanks `@r-hughes`_) `#238`_-* Dummy data generator can not create nutrition plans (thanks `@cthare`_) `#241`_---Other improvements and bugfixes: `#279`_, `#275`_, `#270`_, `#258`_, `#257`_---.. _#126: https://github.com/wger-project/wger/issues/126-.. _#144: https://github.com/wger-project/wger/issues/144-.. _#149: https://github.com/wger-project/wger/issues/149-.. _#159: https://github.com/wger-project/wger/issues/159-.. _#164: https://github.com/wger-project/wger/issues/164-.. _#181: https://github.com/wger-project/wger/issues/181-.. _#184: https://github.com/wger-project/wger/issues/184-.. _#186: https://github.com/wger-project/wger/issues/186-.. _#192: https://github.com/wger-project/wger/issues/192-.. _#197: https://github.com/wger-project/wger/issues/197-.. _#204: https://github.com/wger-project/wger/issues/204-.. _#208: https://github.com/wger-project/wger/issues/208-.. _#210: https://github.com/wger-project/wger/issues/210-.. _#212: https://github.com/wger-project/wger/issues/212-.. _#229: https://github.com/wger-project/wger/issues/229-.. _#220: https://github.com/wger-project/wger/issues/220-.. _#238: https://github.com/wger-project/wger/issues/238-.. _#241: https://github.com/wger-project/wger/issues/241-.. _#244: https://github.com/wger-project/wger/issues/244-.. _#257: https://github.com/wger-project/wger/issues/257-.. _#258: https://github.com/wger-project/wger/issues/258-.. _#261: https://github.com/wger-project/wger/issues/261-.. _#270: https://github.com/wger-project/wger/issues/270-.. _#275: https://github.com/wger-project/wger/issues/275-.. _#279: https://github.com/wger-project/wger/issues/279-.. _@jamessimas: https://github.com/jamessimas-.. _@r-hughes: https://github.com/r-hughes-.. _@romansp: https://github.com/romansp-.. _@cthare: https://github.com/cthare-.. _@warchildmd: https://github.com/warchildmd-.. _@tranbenny: https://github.com/tranbenny---1.6.1-------**2015-07-25**--Bugfix release---1.6-----**2015-07-25**--New translations:--* Greek (many thanks to Mark Nicolaou!)--New features:--* Save planed weight along with the repetitions `#119`_-* Improvements to the workout calendar `#98`_-* Allow external access to workouts and other pages to allow for sharing `#102`_, `#124`_-* Email reminder to regularly enter (body) weight entries `#115`_-* Allow users to submit corrections to exercises-* Add day detail view in workout calendar `#103`_-* Fix bug where the exercises added to a superset did not remain sorted `#89`_-* Reduce the size of generated HTML code `#125`_-* Allow users to copy shared workouts from others `#127`_-* Added breadbrumbs, to make navigation easier `#101`_-* Add option to delete workout sessions and their logs `#156`_-* Improve installation, development and maintenance documentation `#114`_--Other improvements and bugfixes:-`#99`_, `#100`_, `#106`_, `#108`_, `#110`_, `#117`_, `#118`_, `#128`_, `#131`_,-`#135`_, `#145`_, `#155`_----.. _#89: https://github.com/wger-project/wger/issues/89-.. _#98: https://github.com/wger-project/wger/issues/98-.. _#99: https://github.com/wger-project/wger/issues/99-.. _#100: https://github.com/wger-project/wger/issues/100-.. _#101: https://github.com/wger-project/wger/issues/101-.. _#102: https://github.com/wger-project/wger/issues/102-.. _#103: https://github.com/wger-project/wger/issues/103-.. _#106: https://github.com/wger-project/wger/issues/106-.. _#108: https://github.com/wger-project/wger/issues/108-.. _#110: https://github.com/wger-project/wger/issues/110-.. _#114: https://github.com/wger-project/wger/issues/114-.. _#115: https://github.com/wger-project/wger/issues/115-.. _#117: https://github.com/wger-project/wger/issues/117-.. _#118: https://github.com/wger-project/wger/issues/118-.. _#119: https://github.com/wger-project/wger/issues/119-.. _#124: https://github.com/wger-project/wger/issues/124-.. _#125: https://github.com/wger-project/wger/issues/125-.. _#127: https://github.com/wger-project/wger/issues/127-.. _#128: https://github.com/wger-project/wger/issues/128-.. _#131: https://github.com/wger-project/wger/issues/131-.. _#135: https://github.com/wger-project/wger/issues/135-.. _#145: https://github.com/wger-project/wger/issues/145-.. _#155: https://github.com/wger-project/wger/issues/155-.. _#156: https://github.com/wger-project/wger/issues/156---1.5-----**2014-12-16**--New Translations:--* Dutch (many thanks to David Machiels!)-* Portuguese (many thanks to Jefferson Campos!) `#97`_---New features:--* Add support for gym management `#85`_-- * Gym managers can create and manage gyms- * Trainers can see the gym's users and their routines--* Reduce the amount of CSS and JS libraries by using bootstrap as much as possible `#73`_-* Improvements to the REST API `#75`_-- * Add read-write access- * Add live browsing of the API with django rest framework- * Improve documentation- * /api/v1 is marked deprecated--* Show exercise pictures in workout as well-* Detailed view of exercises and workouts in schedule `#86`_-* Support for both metric (kg) and imperial (lb) weight units `#105`_-* Allow the user to delete his account and data `#84`_-* Add contact field to feedback form-* Cleanup translation strings `#94`_-* Python 3 compatibility! `#68`_--Other improvements and bugfixes:-`#51`_, `#76`_, `#80`_, `#81`_, `#82`_, `#91`_, `#92`_, `#95`_, `#96`_---.. _#51: https://github.com/wger-project/wger/issues/51-.. _#68: https://github.com/wger-project/wger/issues/68-.. _#73: https://github.com/wger-project/wger/issues/73-.. _#75: https://github.com/wger-project/wger/issues/75-.. _#76: https://github.com/wger-project/wger/issues/76-.. _#80: https://github.com/wger-project/wger/issues/80-.. _#81: https://github.com/wger-project/wger/issues/81-.. _#82: https://github.com/wger-project/wger/issues/82-.. _#84: https://github.com/wger-project/wger/issues/84-.. _#85: https://github.com/wger-project/wger/issues/85-.. _#86: https://github.com/wger-project/wger/issues/86-.. _#91: https://github.com/wger-project/wger/issues/91-.. _#92: https://github.com/wger-project/wger/issues/92-.. _#94: https://github.com/wger-project/wger/issues/94-.. _#95: https://github.com/wger-project/wger/issues/95-.. _#96: https://github.com/wger-project/wger/issues/96-.. _#97: https://github.com/wger-project/wger/issues/97-.. _#105: https://github.com/wger-project/wger/issues/105---1.4------**2014-03-08**--New features and bugfixes:-- * Calendar view to more easily check workout logs- * Add "gym mode" with timer to log the workout while at the gym- * Add automatic email reminders for new workouts- * New iCal export to add workouts and schedules e.g. to google calendar- * New exercise overview, grouped by equipment- * Add possibility to write comments and rate the workout- * Simplify form for new exercises- * Alternative PDF export of workout without table for entering logs- * Unified way of specifying license of submitted content (exercises, etc.)----1.3------**2013-11-27**---New translations:-- * Bulgarian (many thanks to Lyuboslav Petrov!)- * Russian (many thanks to Inna!)- * Spanish--New features and bugfixes:-- * Mobile version of website- * Add images to the exercises- * Exercises now can list needed equipment (barbell, etc.)- * BMI calculator- * Daily calories calculator- * New management utility for languages- * Improved performance- * RESTful API----1.2-----**2013-05-19**--New features and bugfixes:-- * Added scheduling option for workouts.- * Open all parts of website to all users, this is done by a custom middleware- * Regular users can submit exercises and ingredients to be included in the general list- * Add more 'human' units to ingredients like '1 cup' or '1 slice'- * Add nutritional values calculator on the ingredient detail page- * Several bugfixes- * Usability improvements---1.1.1-------**2013-03-06**---New features and bugfixes:-- * Pin version of app django_browserid due to API changes in 0.8- * Fix issue with tabs on exercise overview due to API changes in JQuery---1.1-----**2013-02-23**--New features and bugfixes:-- * Better navigation bar- * Added descriptions for the exercises (German)- * New workout logbook, to keep track of your improvements- * Import your weight logs from a spreadsheet (CSV-Import)- * Better filtering for weight chart- * Muscle overview with corresponding exercises- * Add guest accounts by generating a temporary user- * Description pages about the software- * Easier installation process---1.0.3-------**2012-11-19**---New features and bugfixes:-- * Add option to copy (duplicate) workouts and nutritional plans- * Login without an account with Mozilla's Persona (BrowserID)- * Better AJAX handling of the modal dialogs, fewer page reloads and redirects- * Expand the list of ingredients in German- * Add pagination to the ingredient list- * Improvements to user page:-- * Add a "reset password" link to the login page- * Email is now user-editable-- * More natural lines in weight chart with cubic interpolation---1.0.2-------**2012-11-02**--Bugfix release---1.0.1-------**2012-11-02**---New features and bugfixes:-- * Fix issue with password change- * Small improvements to UI- * Categories editable/deletable from the exercise overview page- * Exercise AJAX search groups by category- * More tests!- * Use generic views for editing, creating and deleting objects---1.0-----**2012-10-16**--Initial release.--New features and bugfixes:-- * Workout manager- * PDF output for logging progress- * Initial data with the most popular exercises- * Simple weight chart- * Nutrition plan manager- * Simple PDF output- * Initial data with nutritional values from the USDAdiff --git a/docs/codingstyle.rst b/docs/codingstyle.rstdeleted file mode 100644index b71f7abe9..000000000--- a/docs/codingstyle.rst+++ /dev/null@@ -1,27 +0,0 @@-.. _codingstyle:--Coding Style Guide-==================--Python---------Code according to PEP8, but with a maximum line length of 100.---JavaScript-------------* Follow Airbnb ES5 style guide, with the following changes:-- * Disallow named function expressions, except in recursive functions, where a name is needed.- * Console logging is allowed--* Functions called from Django templates need to start with ``wger``---Automatic coding style checks--------------------------------The coding style is automatically checked by GitHub actions after sending a-pull request.diff --git a/docs/commands.rst b/docs/commands.rstdeleted file mode 100644index 020e767f3..000000000--- a/docs/commands.rst+++ /dev/null@@ -1,299 +0,0 @@-Commands-========--Please note that the administration commands are intended e.g. to bootstrap/install-an application to a new system, while the management ones are made to administer a-running application (to e.g. delete guest users, send emails, etc.).--Administration Commands--------------------------The application provides several administration and bootstrapping commands that-can be passed to the ``wger`` command::-- wger <command>---You can get a list of all available commands by calling ``wger`` without any-arguments::-- Available tasks:-- bootstrap Performs all steps necessary to bootstrap the application- config-location Returns the default location for the settings file and the data folder- create-or-reset-admin Creates an admin user or resets the password for an existing one- create-settings Creates a local settings file- load-fixtures Loads all fixtures- load-online-fixtures Downloads fixtures from server and installs them (at the moment only ingredients)- migrate-db Run all database migrations- start Start the application using django's built-in webserver--You can also get help on a specific command with ``wger --help <command>``.--.. note::- Most commands support a ``--settings-path`` command line option that sets the- settings file to use for the operation. If you use it, it is recommended to- use absolute paths, for example::-- wger bootstrap --settings-path /path/to/development/wger/settings-test.py----Bootstrap-~~~~~~~~~--Command: **bootstrap**--This command bootstraps the application: it creates a settings file, initialises-a SQLite database, loads all necessary fixtures for the application to work and-creates a default administrator user. While it can also work with e.g. a PostgreSQL-database, you will need to create it yourself::-- wger bootstrap--The most usual use-case is creating the settings file and the SQLite database to-their default locations, but you can set your own paths if you want e.g. start-developing on a branch that is going to change the database schema.--Usage::-- Usage: inv[oke] [--core-opts] bootstrap [--options] [other tasks here ...]-- Docstring:- Performs all steps necessary to bootstrap the application-- Options:- -a STRING, --address=STRING Address to use. Default: localhost- -b, --browser Whether to open the application in a browser window. Default: false- -d STRING, --database-path=STRING Path to SQLite database (absolute path recommended). Leave empty for default- -p, --port Port to use. Default: 8000- -s STRING, --settings-path=STRING Path to settings file (absolute path recommended). Leave empty for default---Start wger-~~~~~~~~~~--Command: **start**--Starts an already installed application::-- wger start--Please note that this is simply a comfort function and does not use any *magic*,-it simply calls Django's development server and (optionally) opens a browser-window. If you are developing, using the usual ``python manage.py runserver``-is probably better.--Usage::-- Usage: inv[oke] [--core-opts] start [--options] [other tasks here ...]-- Docstring:- Start the application using django's built in webserver-- Options:- -a STRING, --address=STRING Address to bind to. Default: localhost- -b, --browser Whether to open the application in a browser window. Default: false- -e STRING, --extra-args=STRING Additional arguments to pass to the builtin server. Pass as string: "--arg1 --arg2=value". Default: none- -p, --port Port to use. Default: 8000- -s STRING, --settings-path=STRING Path to settings file. Leave empty for default- -t, --[no-]start-server Whether to start the development server. Default: true---Default locations-~~~~~~~~~~~~~~~~~--Command: **config-location**--Information command that simply outputs the default locations for the settings-file as well as the data folder used for the SQLite database and the uploaded-files.---Create settings-~~~~~~~~~~~~~~~--Command: **create-settings**--Creates a new settings file-based. If you call it without further arguments it-will create the settings in the default locations::-- wger create-settings--If you pass custom paths, it's recommended to use absolute paths::-- wger create-settings --settings-path /path/to/development/wger/settings-test.py --database-path /path/to/development/wger/database-test.sqlite---Usage::-- Usage: inv[oke] [--core-opts] create-settings [--options] [other tasks here ...]-- Docstring:- Creates a local settings file-- Options:- -a STRING, --database-type=STRING Database type to use. Supported: SQLite3, postgresql. Default: SQLite3- -d STRING, --database-path=STRING Path to SQLite database (absolute path recommended). Leave empty for default- -k, --key-length Lenght of the generated secret key. Default: 50- -s STRING, --settings-path=STRING Path to settings file (absolute path recommended). Leave empty for default- -u STRING, --url=STRING----Create or reset admin-~~~~~~~~~~~~~~~~~~~~~--Command: **create-or-reset-admin**--Makes sure that the default administrator user exists. If you change the password,-it is reset.---Usage::-- Usage: inv[oke] [--core-opts] create-or-reset-admin [--options] [other tasks here ...]-- Docstring:- Creates an admin user or resets the password for an existing one-- Options:- -s STRING, --settings-path=STRING Path to settings file (absolute path recommended). Leave empty for default----Migrate database-~~~~~~~~~~~~~~~~--Command: **migrate-db**--Migrates the database schema. This command is called internally when installing-the application. The only need to call this explicitly is after installing a new-version of the application.--Calling this command is a safe operation, if your database is current, nothing-will happen.---Usage::-- Usage: inv[oke] [--core-opts] migrate-db [--options] [other tasks here ...]-- Docstring:- Run all database migrations-- Options:- -s STRING, --settings-path=STRING Path to settings file (absolute path recommended). Leave empty for default----Load fixtures-~~~~~~~~~~~~~--Command: **load-fixtures**--Loads all fixture files with the default data. This data includes all data necessary-for the application to work such as:--* exercises, muscles, equipment-* ingredients, units-* languages-* permission groups-* etc.--Note that ingredients are not included and need to be installed separately with-download-online-fixtures.--This command is called internally when installing the application but you can use-it to reset the data to the original state. Note: new entries or user entries such-as workouts are *not* reset with this, only the application data.--Usage::-- Usage: inv[oke] [--core-opts] load-fixtures [--options] [other tasks here ...]-- Docstring:- Loads all fixtures-- Options:- -s STRING, --settings-path=STRING Path to settings file (absolute path recommended). Leave empty for default---Load online fixtures-~~~~~~~~~~~~~~~~~~~~--Command: **load-online-fixtures**--Downloads ingredient and weight units fixtures and installs them. They are not-included in the repository due to size.--This command is called internally when installing the application but you can use-it to reset the data to the original state. Note: new entries or user entries such-as workouts are *not* reset with this, only the application data.--Usage::-- Usage: inv[oke] [--core-opts] load-online-fixtures [--options] [other tasks here ...]-- Docstring:- Downloads fixtures from server and installs them (at the moment only ingredients)-- Options:- -s STRING, --settings-path=STRING Path to settings file (absolute path). Leave empty for default---Management commands----------------------wger also implements a series of Django commands that perform different-management functions that are sometimes needed. Call them with-``python manage.py <command_name>``:--**download-exercise-images**- synchronizes the exercise images from wger.de to the local installation. Read- its help text as it could save the wrong image to the wrong exercise should- different IDs match.--**redo-capitalize-names**- re-calculates the capitalized exercise names. This command can be called if the- current "smart" capitalization algorithm is changed. This is a safe operation- since the original names (as entered by the user) are still available.--**submitted-exercises**- simply prints a list of user-submitted exercises--**extract-i18n**- extract strings from the database that have to be inserted manually in the PO- file when translating. These include e.g. exercise categories.--**clear-cache**- clears different application caches. Might be needed after some updates or- just useful while testing. Please note that you must select what caches to- clear.--**update-user-cache**- update the user cache-table. This command is only needed when the python code- used to calculate any of the cached entries is changed and the ones in the- database need to be updated to reflect the new logic.----Cron-~~~~--The following commands are built to be called regularly, via a cronjob or-similar--**delete-temp-users**- deletes all guest users older than 1 week. At the moment this value can't be- configured--**email-reminders**- sends out email reminders for a user that need to create a new workout.--**email-weight-reminders**- sends out email reminders for a user that need to enter a new (body) weight entry.--**inactive-members**- Sends email for gym members that have not been to the gym for a specified- amount of weeks.diff --git a/docs/conf.py b/docs/conf.pydeleted file mode 100644index 4b4c2149a..000000000--- a/docs/conf.py+++ /dev/null@@ -1,262 +0,0 @@-# -*- coding: utf-8 -*---#-# wger Workout Manager documentation build configuration file, created by-# sphinx-quickstart on Mon Dec 1 22:22:02 2014.-#-# This file is execfile()d with the current directory set to its-# containing dir.-#-# Note that not all possible configuration values are present in this-# autogenerated file.-#-# All configuration values have a default; values that are commented out-# serve to show the default.--import sys-import os--# If extensions (or modules to document with autodoc) are in another directory,-# add these directories to sys.path here. If the directory is relative to the-# documentation root, use os.path.abspath to make it absolute, like shown here.-#sys.path.insert(0, os.path.abspath('.'))--# -- General configuration --------------------------------------------------# If your documentation needs a minimal Sphinx version, state it here.-#needs_sphinx = '1.0'--# Add any Sphinx extension module names here, as strings. They can be-# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom-# ones.-extensions = [- 'sphinx.ext.autodoc',- 'sphinx.ext.doctest',-]--# Add any paths that contain templates here, relative to this directory.-templates_path = ['_templates']--# The suffix of source filenames.-source_suffix = '.rst'--# The encoding of source files.-#source_encoding = 'utf-8-sig'--# The master toctree document.-master_doc = 'index'--# General information about the project.-project = 'wger Workout Manager'-copyright = '2020, Roland Geider'--# The version info for the project you're documenting, acts as replacement for-# |version| and |release|, also used in various other places throughout the-# built documents.-#-# The short X.Y version.-version = '2.1'-# The full version, including alpha/beta/rc tags.-release = '2.1 alpha'--# The language for content autogenerated by Sphinx. Refer to documentation-# for a list of supported languages.-#language = None--# There are two options for replacing |today|: either, you set today to some-# non-false value, then it is used:-#today = ''-# Else, today_fmt is used as the format for a strftime call.-#today_fmt = '%B %d, %Y'--# List of patterns, relative to source directory, that match files and-# directories to ignore when looking for source files.-exclude_patterns = ['_build']--# The reST default role (used for this markup: `text`) to use for all-# documents.-#default_role = None--# If true, '()' will be appended to :func: etc. cross-reference text.-#add_function_parentheses = True--# If true, the current module name will be prepended to all description-# unit titles (such as .. function::).-#add_module_names = True--# If true, sectionauthor and moduleauthor directives will be shown in the-# output. They are ignored by default.-#show_authors = False--# The name of the Pygments (syntax highlighting) style to use.-pygments_style = 'sphinx'--# A list of ignored prefixes for module index sorting.-#modindex_common_prefix = []--# If true, keep warnings as "system message" paragraphs in the built documents.-#keep_warnings = False---# -- Options for HTML output ------------------------------------------------# The theme to use for HTML and HTML Help pages. See the documentation for-# a list of builtin themes.-html_theme = 'default'--# Theme options are theme-specific and customize the look and feel of a theme-# further. For a list of options available for each theme, see the-# documentation.-#html_theme_options = {}--# Add any paths that contain custom themes here, relative to this directory.-#html_theme_path = []--# The name for this set of Sphinx documents. If None, it defaults to-# "<project> v<release> documentation".-#html_title = None--# A shorter title for the navigation bar. Default is the same as html_title.-#html_short_title = None--# The name of an image file (relative to this directory) to place at the top-# of the sidebar.-#html_logo = None--# The name of an image file (within the static path) to use as favicon of the-# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32-# pixels large.-#html_favicon = None--# Add any paths that contain custom static files (such as style sheets) here,-# relative to this directory. They are copied after the builtin static files,-# so a file named "default.css" will overwrite the builtin "default.css".-html_static_path = ['_static']--# Add any extra paths that contain custom files (such as robots.txt or-# .htaccess) here, relative to this directory. These files are copied-# directly to the root of the documentation.-#html_extra_path = []--# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,-# using the given strftime format.-#html_last_updated_fmt = '%b %d, %Y'--# If true, SmartyPants will be used to convert quotes and dashes to-# typographically correct entities.-#html_use_smartypants = True--# Custom sidebar templates, maps document names to template names.-#html_sidebars = {}--# Additional templates that should be rendered to pages, maps page names to-# template names.-#html_additional_pages = {}--# If false, no module index is generated.-#html_domain_indices = True--# If false, no index is generated.-#html_use_index = True--# If true, the index is split into individual pages for each letter.-#html_split_index = False--# If true, links to the reST sources are added to the pages.-#html_show_sourcelink = True--# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.-#html_show_sphinx = True--# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True.-#html_show_copyright = True--# If true, an OpenSearch description file will be output, and all pages will-# contain a <link> tag referring to it. The value of this option must be the-# base URL from which the finished HTML is served.-#html_use_opensearch = ''--# This is the file name suffix for HTML files (e.g. ".xhtml").-#html_file_suffix = None--# Output file base name for HTML help builder.-htmlhelp_basename = 'wgerWorkoutManagerdoc'---# -- Options for LaTeX output -----------------------------------------------latex_elements = {-# The paper size ('letterpaper' or 'a4paper').-#'papersize': 'letterpaper',--# The font size ('10pt', '11pt' or '12pt').-#'pointsize': '10pt',--# Additional stuff for the LaTeX preamble.-#'preamble': '',-}--# Grouping the document tree into LaTeX files. List of tuples-# (source start file, target name, title,-# author, documentclass [howto, manual, or own class]).-latex_documents = [- ('index', 'wgerWorkoutManager.tex', 'wger Workout Manager Documentation',- 'Roland Geider', 'manual'),-]--# The name of an image file (relative to this directory) to place at the top of-# the title page.-#latex_logo = None--# For "manual" documents, if this is true, then toplevel headings are parts,-# not chapters.-#latex_use_parts = False--# If true, show page references after internal links.-#latex_show_pagerefs = False--# If true, show URL addresses after external links.-#latex_show_urls = False--# Documents to append as an appendix to all manuals.-#latex_appendices = []--# If false, no module index is generated.-#latex_domain_indices = True---# -- Options for manual page output -----------------------------------------# One entry per manual page. List of tuples-# (source start file, name, description, authors, manual section).-man_pages = [- ('index', 'wgerworkoutmanager', 'wger Workout Manager Documentation',- ['Roland Geider'], 1)-]--# If true, show URL addresses after external links.-#man_show_urls = False---# -- Options for Texinfo output ---------------------------------------------# Grouping the document tree into Texinfo files. List of tuples-# (source start file, target name, title, author,-# dir menu entry, description, category)-texinfo_documents = [- ('index', 'wgerWorkoutManager', 'wger Workout Manager Documentation',- 'Roland Geider', 'wgerWorkoutManager', 'One line description of project.',- 'Miscellaneous'),-]--# Documents to append as an appendix to all manuals.-#texinfo_appendices = []--# If false, no module index is generated.-#texinfo_domain_indices = True--# How to display URL addresses: 'footnote', 'no', or 'inline'.-#texinfo_show_urls = 'footnote'--# If true, do not generate a @detailmenu in the "Top" node's menu.-#texinfo_no_detailmenu = Falsediff --git a/docs/development.rst b/docs/development.rstdeleted file mode 100644index eb4bdb8e5..000000000--- a/docs/development.rst+++ /dev/null@@ -1,58 +0,0 @@-.. _development:--Development-===========--Virtual environment-~~~~~~~~~~~~~~~~~~~--Create a new virtualenv::-- $ python3 -m venv venv-wger- $ source venv-wger/bin/activate---Get the code-~~~~~~~~~~~~--Download the source code::-- $ git clone https://github.com/wger-project/wger.git src- $ cd src--Install Requirements-~~~~~~~~~~~~~~~~~~~~--Install python requirements::-- $ pip install -r requirements_dev.txt- $ python setup.py develop--Install application-~~~~~~~~~~~~~~~~~~~--This will download the required JS and CSS libraries and create an SQLite-database and populate it with data on the first run::--- $ wger create-settings- $ wger bootstrap- $ wger load-online-fixtures--You can of course also use other databases such as PostgreSQL or MariaDB. Create-a database and user and edit the DATABASES settings before calling bootstrap.-Take a look at the :ref:`prod_postgres` on apache on how that could look like.--Start the server-------------------After the first run you can just use Django's development server::-- $ python manage.py runserver--That's it. You can log in with the default administrator user:--* **username**: admin-* **password**: adminadmin--You can reset the admin's password with ``wger create-or-reset-admin``.diff --git a/docs/docker.rst b/docs/docker.rstdeleted file mode 100644index 9580ca4e5..000000000--- a/docs/docker.rst+++ /dev/null@@ -1,66 +0,0 @@-Docker images-=============--There are docker files available to quickly get a version of wger up and-running. They are all located under ``extras/docker`` if you want to build-them yourself.--Note that you need to build from the project's source folder, e.g::-- docker build -f extras/docker/development/Dockerfile -t wger/server .- docker build -f extras/docker/demo/Dockerfile --tag wger/demo .---Demo-------Self contained demo image--Get the image::-- docker pull wger/demo--Run a container and start the application::-- docker run -ti --name wger.demo --publish 8000:80 wger/demo---Then just open http://localhost:8000 and log in as: **admin**, password **adminadmin**---Development--------------This image installs the application using virtualenv, uses an SQLite database-and serves it with Django's development server.--Get the image::-- docker pull wger/server--Run a container and start the application::-- docker run -ti --name wger.dev --publish 8000:8000 wger/server- (in docker) source ~/venv/bin/activate- (in docker) python manage.py runserver 0.0.0.0:8000--Then just open http://localhost:8000 and log in as: **admin**, password **adminadmin**--As an alternative, you might want to map a local folder to the container.-This is interesting if e.g. you want to keep the wger source code on-your host machine and use docker only to serve it. Then do this::-- docker run -ti \- --name wger.test1 \- --publish 8005:8000 \- --volume /path/to/local/wger/:/home/wger/src \- wger/server--It will mount the local path *on top* of the folder in the container. For this to-work you obviously need to manually checkout the code to ``/path/to/local/wger/``-and create a settings file as well.--Production-------------The production docker compose setup can be found here: https://github.com/wger-project/dockerdiff --git a/docs/gym.rst b/docs/gym.rstdeleted file mode 100644index 7b07747da..000000000--- a/docs/gym.rst+++ /dev/null@@ -1,126 +0,0 @@-.. _gym:--Gym administration---------------------wger provides support for managing both gyms and members. For example,-trainers/coaches can follow their students progress, and gym managers are-able to keep track of their members contracts.--If the installation is being used for a single gym, you can set the-default gym in the global configuration options in the gym list. This will-update all existing users as well as newly registered ones so they belong-to that gym.---There are 3 groups used for the different administrative roles:--* **General Manager:** Can manage (add, edit, delete) the different gyms for the- installation as well as add gym managers, trainers, and members but is not- allowed to see the members' workout data.-* **Gym Manager:** Can manage the users for a single gym (editing, deactivating,- and adding contracts, etc.).-* **Trainer:** Can manage the workouts and other data for the members of a- single gym.----These roles are not mutually exclusive, if your workflow demands it, you can-combine all three roles into one account.--Except for general managers, administrative users belong to a single gym (the-one they were created in) and can access only those members. This setting cannot-be changed later. The user's gym appears in the top-right menu.--Member Management-------------------To add members to a gym:--1. Click the ``Add Member`` button at the top of the member overview.-2. Fill in the form to generate a password for the user.-3. Save this password and give it to the user and it cannot be retrieved later.-- OR--1. Click the ``Add Member`` button at the top of the member overview.-2. Instruct new members to use the reset password links when logging in for the first time.---To export all gym members:--1. Navigate to the ``Actions`` button on the gym detail page.-2. Here, you are provided with a CSV file that can be imported into a spreadsheet program for further processing.---Trainers can click on a user and access an overview of the user's workouts,-body weights, nutrition plans, etc. When clicking on the "log in as this user",-the trainer can assume the identity of the user to create new workouts for-example.-Additionally, Trainers can add notes and upload documents related to individual members. A-note is a free text, while a document can be any file. This information can-be used to save information on specific injuries or other important notes-related to the member. Note that these entries are not accessible by the-members themselves, but only by the trainers.--Individual members can be deactivated by clicking on the "actions" button on-the top of the member's detail table. Deactivated users can't log in, but are-not deleted from the system and can be reactivated at any time in the future.-If you wish to completely delete a user from the system, use the "delete"-option but keep in mind that this action cannot be undone.---Contracts------------It is also possible to manage the members' contracts with the application. A-contract is composed of a base form and optional *type* and *options*. The type-is a single attribute, such as "Student contract" or "Special offer 2016". The-options are basically the same but more than one can be selected at once and-can be used for items that can e.g. be booked in addition to the default-contract such as "Sauna" or "Protein drink flatrate".--The types and the options are added gym-wide in the member overview by the-managers. Once these are saved, they can be used when adding or editing a-contract to a specific user.---E-Mails-------------You can send a batch e-mail to all members of a gym. Currently, there is no support-for filtering members based on specific criterion.---How to send e-mails:--1. Navigate to the gym's overview and click "Add" on the Email actions button.-2. Fill in the subject and the body.-3. Review, and accept the e-mail's preview.-4. After submitting, emails will be delivered in batch format based on your cron jobs configuration.---Configuration----------------Inactive members-~~~~~~~~~~~~~~~~-Inactive members are members that have not logged in for X weeks. For example, a trainer can check to-see which users have not visited the gym in X weeks.--This can be configured in the following ways:--**Number of Weeks**- The value in weeks after which users are considered inactive (default is 8).- This applies to the whole gym and can be deactivated by entering a 0.--**Trainer Configuration**- Each trainer can opt-out of receiving such emails.--**User Configuration**- Individual users can be opt-out of being included in the reminder emails if- they don't want to use the log for any other reason.--Gym name in the header-~~~~~~~~~~~~~~~~~~~~~~-A checkbox to control whether the gym's name will appear in the header instead-of the application's name for all logged-in users of this gym. This applies to-members, trainers, and managersdiff --git a/docs/i18n.rst b/docs/i18n.rstdeleted file mode 100644index bbc6e41da..000000000--- a/docs/i18n.rst+++ /dev/null@@ -1,97 +0,0 @@-.. _i18n:--Internationalization (i18n)-===========================--Django---------Updating the translation files-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~--wger uses Django's translation infrastructure, but there are a couple of things-that need to be considered. First, you need to extract some translatable strings-from the database such as exercise categories and muscle names::-- python manage.py extract-i18n--Then, update your po files with the usual Django command (run this in the wger-sub folder, not the root one)::-- django-admin makemessages --all --extension py,html,tpl---and finally, you can compile them with::-- django-admin compilemessages---Adding new languages-~~~~~~~~~~~~~~~~~~~~--Besides adding the new translations to the locale folder, they have to be-activated in the Django settings file and in the application itself.--.. note::- At the moment composed language codes such as pt-BR (Brazilian Portuguese)- are **not** supported, the issue for this problem is `#130`_--.. _#130: https://github.com/wger-project/wger/issues/130--* **django:** add an entry to ``LANGUAGES`` in ``wger/settings_global.py``--* **wger:** add the new language in the language admin page and set the- visibility of exercises and ingredients. For the short name, use the- language code such as 'fr', for the long name the native name, in this example- 'français'.--* **compile**: to use the new language files, the translation files have to be- compiled. Do this by changing to the wger folder (so you see a ``locale``- folder there) and invoking ``django-admin compilemessages``. You will also- need to restart the webserver.--* **flag icon:** add an appropriate flag icon in SVG format in ``images/icons/flag-CODE.svg``- in the static folder of the core application.--* **fixtures:** after having added the language in the admin module, the data- has to be exported so the current language configuration can be reproduced.- This is done with the ``filter-fixtures.py`` script:-- * while in ``extras/scripts``, export the whole database to a JSON file with::-- python ../../manage.py dumpdata --indent 4 --natural-foreign > data.json-- * filter the database dump, this will generate a json file for each "important"- module::-- python filter-fixtures.py-- * copy the generated files ``languages.json`` and ``language_config.json`` to- the fixtures folder in core and config (you'll probably want to delete the- remaining JSON files)::-- cp languages.json ../../wger/core/fixtures/- cp language_config.json ../../wger/config/fixtures/- rm *.json---Getting new languages-~~~~~~~~~~~~~~~~~~~~~--If you have a local installation and new languages arrive from upstream, you-need to load the necessary data to the language tables in the database (note-that you'll need to reload/restart the webserver so the new po files are picked-up)::-- python manage.py loaddata languages- python manage.py loaddata language_config--Please note that this will overwrite any changes you might have done from the-language administration module.---React--------The frontend that is built with react uses its own translation files. See-the README.md file in the locale folder in the react repo for more information.diff --git a/docs/index.rst b/docs/index.rstdeleted file mode 100644index 489bdda4b..000000000--- a/docs/index.rst+++ /dev/null@@ -1,89 +0,0 @@-.. wger Workout Manager documentation master file, created by- sphinx-quickstart on Mon Dec 1 22:22:02 2014.- You can adapt this file completely to your liking, but it should at least- contain the root `toctree` directive.--Welcome to wger Workout Manager's documentation!-================================================--wger (ˈvɛɡɐ) Workout Manager is a free, open-source web application that helps-you manage your personal workouts, weight, and diet plans and can also be used-as a simple gym management utility. It offers a REST API as well, for easy-integration with other projects and tools.--For more details and a live system, refer to the project's site:-https://github.com/wger-project/wger---This documentation is intended for developers and administrators of the software.---Installation and administration---------------------------------.. toctree::-- installation---Development---------------------------------.. toctree::-- tips_and_tricks- codingstyle- i18n---Administration guide----------------------.. toctree::-- commands- settings- gym---Changelog-----------.. toctree::- :maxdepth: 2-- changelog--Contact----------Feel free to contact us if you found this useful or if there was something that-didn't behave as you expected (in this case you can also open a ticket on the-issue tracker).--* **discord:** https://discord.gg/rPWFv6W-* **issue tracker:** https://github.com/wger-project/wger/issues-* **twitter:** https://twitter.com/wger_project---Sources----------All the code and the content is freely available and is hosted on GitHub:-https://github.com/wger-project/wger---Licence----------The application is licenced under the Affero GNU General Public License 3 or-later (AGPL 3+).--The initial exercise and ingredient data is licensed additionally under a-Creative Commons Attribution Share-Alike 3.0 (CC-BY-SA 3.0)--The documentation is released under a CC-BY-SA either version 4 of the License,-or (at your option) any later version.--Some images were taken from Wikipedia, see the SOURCES file in their respective-folders for more details.--.. include the authors file from the root folder-.. include:: ../AUTHORS.rst-diff --git a/docs/installation.rst b/docs/installation.rstdeleted file mode 100644index 0eec32d5e..000000000--- a/docs/installation.rst+++ /dev/null@@ -1,45 +0,0 @@-.. _installation:--Installation-============--You can get a local instance of wger installed in a couple of minutes.--It is recommended to install a development instance or start a docker-image if you just want to try the application on your server or PC. All-the following steps are performed on a Debian-based Linux distribution.-If your setup differs (e.g. in Red Hat based distros the package names are-slightly different) you will need to change the steps as appropriate.--You can safely install from master, it is almost always in a usable and-stable state.--The application is compatible and regularly tested with--* PostgreSQL, sqlite-* python 3.8, 3.9, 3.10 and pypy3--After installation, you might also want to take a look at the :ref:`other-changes` section for other-changes you might want to do to your local instance such as Terms of Service or-contact page.--.. note::- Please note that all the steps related to upgrading the database or- downloading external JS dependencies mentioned in the :ref:`tips` section- in the development page apply to all the installation options.---These are the necessary packages for both development and production::-- sudo apt-get install nodejs npm git python3-dev python3-venv- sudo npm install -g yarn sass---.. toctree::- :maxdepth: 1-- development- production- docker- updating-diff --git a/docs/make.bat b/docs/make.batdeleted file mode 100644index 223a7367a..000000000--- a/docs/make.bat+++ /dev/null@@ -1,242 +0,0 @@-@ECHO OFF--REM Command file for Sphinx documentation--if "%SPHINXBUILD%" == "" (- set SPHINXBUILD=sphinx-build-)-set BUILDDIR=_build-set ALLSPHINXOPTS=-d %BUILDDIR%/doctrees %SPHINXOPTS% .-set I18NSPHINXOPTS=%SPHINXOPTS% .-if NOT "%PAPER%" == "" (- set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%- set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%-)--if "%1" == "" goto help--if "%1" == "help" (- :help- echo.Please use `make ^<target^>` where ^<target^> is one of- echo. html to make standalone HTML files- echo. dirhtml to make HTML files named index.html in directories- echo. singlehtml to make a single large HTML file- echo. pickle to make pickle files- echo. json to make JSON files- echo. htmlhelp to make HTML files and a HTML help project- echo. qthelp to make HTML files and a qthelp project- echo. devhelp to make HTML files and a Devhelp project- echo. epub to make an epub- echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter- echo. text to make text files- echo. man to make manual pages- echo. texinfo to make Texinfo files- echo. gettext to make PO message catalogs- echo. changes to make an overview over all changed/added/deprecated items- echo. xml to make Docutils-native XML files- echo. pseudoxml to make pseudoxml-XML files for display purposes- echo. linkcheck to check all external links for integrity- echo. doctest to run all doctests embedded in the documentation if enabled- goto end-)--if "%1" == "clean" (- for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i- del /q /s %BUILDDIR%\*- goto end-)---%SPHINXBUILD% 2> nul-if errorlevel 9009 (- echo.- echo.The 'sphinx-build' command was not found. Make sure you have Sphinx- echo.installed, then set the SPHINXBUILD environment variable to point- echo.to the full path of the 'sphinx-build' executable. Alternatively you- echo.may add the Sphinx directory to PATH.- echo.- echo.If you don't have Sphinx installed, grab it from- echo.http://sphinx-doc.org/- exit /b 1-)--if "%1" == "html" (- %SPHINXBUILD% -b html %ALLSPHINXOPTS% %BUILDDIR%/html- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The HTML pages are in %BUILDDIR%/html.- goto end-)--if "%1" == "dirhtml" (- %SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.- goto end-)--if "%1" == "singlehtml" (- %SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.- goto end-)--if "%1" == "pickle" (- %SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle- if errorlevel 1 exit /b 1- echo.- echo.Build finished; now you can process the pickle files.- goto end-)--if "%1" == "json" (- %SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json- if errorlevel 1 exit /b 1- echo.- echo.Build finished; now you can process the JSON files.- goto end-)--if "%1" == "htmlhelp" (- %SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp- if errorlevel 1 exit /b 1- echo.- echo.Build finished; now you can run HTML Help Workshop with the ^-.hhp project file in %BUILDDIR%/htmlhelp.- goto end-)--if "%1" == "qthelp" (- %SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp- if errorlevel 1 exit /b 1- echo.- echo.Build finished; now you can run "qcollectiongenerator" with the ^-.qhcp project file in %BUILDDIR%/qthelp, like this:- echo.^> qcollectiongenerator %BUILDDIR%\qthelp\wgerWorkoutManager.qhcp- echo.To view the help file:- echo.^> assistant -collectionFile %BUILDDIR%\qthelp\wgerWorkoutManager.ghc- goto end-)--if "%1" == "devhelp" (- %SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp- if errorlevel 1 exit /b 1- echo.- echo.Build finished.- goto end-)--if "%1" == "epub" (- %SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The epub file is in %BUILDDIR%/epub.- goto end-)--if "%1" == "latex" (- %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex- if errorlevel 1 exit /b 1- echo.- echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.- goto end-)--if "%1" == "latexpdf" (- %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex- cd %BUILDDIR%/latex- make all-pdf- cd %BUILDDIR%/..- echo.- echo.Build finished; the PDF files are in %BUILDDIR%/latex.- goto end-)--if "%1" == "latexpdfja" (- %SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex- cd %BUILDDIR%/latex- make all-pdf-ja- cd %BUILDDIR%/..- echo.- echo.Build finished; the PDF files are in %BUILDDIR%/latex.- goto end-)--if "%1" == "text" (- %SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The text files are in %BUILDDIR%/text.- goto end-)--if "%1" == "man" (- %SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The manual pages are in %BUILDDIR%/man.- goto end-)--if "%1" == "texinfo" (- %SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.- goto end-)--if "%1" == "gettext" (- %SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The message catalogs are in %BUILDDIR%/locale.- goto end-)--if "%1" == "changes" (- %SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes- if errorlevel 1 exit /b 1- echo.- echo.The overview file is in %BUILDDIR%/changes.- goto end-)--if "%1" == "linkcheck" (- %SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck- if errorlevel 1 exit /b 1- echo.- echo.Link check complete; look for any errors in the above output ^-or in %BUILDDIR%/linkcheck/output.txt.- goto end-)--if "%1" == "doctest" (- %SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest- if errorlevel 1 exit /b 1- echo.- echo.Testing of doctests in the sources finished, look at the ^-results in %BUILDDIR%/doctest/output.txt.- goto end-)--if "%1" == "xml" (- %SPHINXBUILD% -b xml %ALLSPHINXOPTS% %BUILDDIR%/xml- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The XML files are in %BUILDDIR%/xml.- goto end-)--if "%1" == "pseudoxml" (- %SPHINXBUILD% -b pseudoxml %ALLSPHINXOPTS% %BUILDDIR%/pseudoxml- if errorlevel 1 exit /b 1- echo.- echo.Build finished. The pseudo-XML files are in %BUILDDIR%/pseudoxml.- goto end-)--:enddiff --git a/docs/production.rst b/docs/production.rstdeleted file mode 100644index 6fc53c1fb..000000000--- a/docs/production.rst+++ /dev/null@@ -1,206 +0,0 @@-Production-==========--Wger user------------It is recommended to add a dedicated user for the application::-- sudo adduser wger --disabled-password --gecos ""--The following steps assume you did, but it is not necessary (nor is it-necessary to call it 'wger'). In that case, change the paths as needed.--Apache---------Install apache and the WSGI module::-- sudo apt-get install apache2 libapache2-mod-wsgi-py3- sudo vim /etc/apache2/sites-available/wger.conf---Configure apache to serve the application::-- <Directory /home/wger/src>- <Files wsgi.py>- Require all granted- </Files>- </Directory>--- <VirtualHost *:80>- WSGIDaemonProcess wger python-path=/home/wger/src python-home=/home/wger/venv- WSGIProcessGroup wger- WSGIScriptAlias / /home/wger/src/wger/wsgi.py-- Alias /static/ /home/wger/static/- <Directory /home/wger/static>- Require all granted- </Directory>-- Alias /media/ /home/wger/media/- <Directory /home/wger/media>- Require all granted- </Directory>-- ErrorLog ${APACHE_LOG_DIR}/wger-error.log- CustomLog ${APACHE_LOG_DIR}/wger-access.log combined- </VirtualHost>--Apache has a problem when uploading files that have non-ASCII characters, e.g.-for exercise images. To avoid this, add to /etc/apache2/envvars (if there is-already an ``export LANG``, replace it) or set your system's locale::-- export LANG='en_US.UTF-8'- export LC_ALL='en_US.UTF-8'---Activate the settings and disable apache's default::-- sudo a2dissite 000-default.conf- sudo a2ensite wger- sudo service apache2 reload--Database-----------.. _prod_postgres:--PostgreSQL-~~~~~~~~~~--Install the Postgres server and create a database and a user::-- sudo apt-get install postgresql postgresql-server-dev-12 # or appropriate version- sudo su - postgres- createdb wger- psql wger -c "CREATE USER wger WITH PASSWORD 'wger'";- psql wger -c "GRANT ALL PRIVILEGES ON DATABASE wger to wger";--You might want or need to edit your ``pg_hba.conf`` file to allow local socket-connections or similar.---SQLite-~~~~~~--If using sqlite, create a folder for it (must be writable by the apache user)::-- mkdir db- touch db/database.sqlite- chown :www-data -R /home/wger/db- chmod g+w /home/wger/db /home/wger/db/database.sqlite--Application--------------Make a virtualenv for python and activate it::-- python3 -m venv /home/wger/venv- source /home/wger/venv/bin/activate--Create folders to collect all static resources and save uploaded files. The-``static`` folder will only contain CSS and JS files, so it must be readable-by the apache process while ``media`` will contain the uploaded files and must-be writeable as well::-- mkdir static-- mkdir media- chmod o+w media--Get the application::-- git clone https://github.com/wger-project/wger.git /home/wger/src- cd /home/wger/src- pip install -r requirements.txt- python setup.py develop- # Only if using postgres- pip install psycopg2-- # If using sqlite without the --database-path- wger create-settings --database-path /home/wger/db/database.sqlite--Edit the settings file--* Add the correct values for the database (use ``django.db.backends.postgresql``- for the engine) if you are using postgres--* Set ``MEDIA_ROOT`` to ``/home/wger/media`` and ``STATIC_ROOT`` to ``/home/wger/static``.--* Add the domains that your site will be accessed to `ALLOWED_HOSTS=['example.com', 'www.example.com']`- (you might want to do this as the last step when you know everything else is- working correctly)--Run the installation script, this will download some CSS and JS libraries and-load all initial data::-- wger bootstrap---Collect all static resources::-- python manage.py collectstatic---The bootstrap command will also create a default administrator user (you probably-want to change the password as soon as you log in):---* **username**: admin-* **password**: adminadmin--.. _email:---------The application is configured to use Django's console email backend by default, which causes messages intended to be sent via email to be written to ``stdout``.--In order to use a real email server, another backend listed in `Django's documentation`_ can be configured instead. Parameters for the backend are set as variables in ``settings.py``. For example, the following allows an SMTP server at ``smtp.example.com`` to be used::-- Email_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'- ENABLE_EMAIL = True- EMAIL_HOST = 'smtp.example.com'- EMAIL_PORT = 587- EMAIL_HOST_USER = '[email protected]'- EMAIL_HOST_PASSWORD = 'example_password'- EMAIL_USE_TLS = True- EMAIL_USE_SSL = False- DEFAULT_FROM_EMAIL = 'wger Workout Manager <[email protected]>'--Django provides a ``sendtestemail`` command via ``manage.py`` to test email settings::-- python manage.py sendtestemail [email protected]--.. _`Django's documentation`: https://docs.djangoproject.com/en/dev/topics/email/#email-backends--.. _site-settings:--Site Settings----------------Some wger features make use of Django's site name and domain settings in the ``contrib.sites`` framework. These should be set through the Python shell::-- python manage.py shell- >>> from django.contrib.sites.models import Site- >>> site = Site.objects.get(pk=1)- >>> site.domain = 'wger.example.com'- >>> site.name = 'example.com wger Workout Manager'- >>> site.save()--where ``wger.example.com`` is the domain of the wger instance. This assumes that wger is using the default site ID of 1. If a different site ID is being used, it must be specified in ``settings.py``::-- SITE_ID = 2--.. _other-changes:--Other changes----------------If you want to use the application as a public instance, you will probably want to-change the following templates:--* **tos.html**, for your own Terms Of Service here-* **about.html**, for your contact address or other such legal requirementsdiff --git a/docs/settings.rst b/docs/settings.rstdeleted file mode 100644index 3b2f58cb3..000000000--- a/docs/settings.rst+++ /dev/null@@ -1,36 +0,0 @@-.. _settings:--Settings-========--You can configure some of the application behaviour with the ``WGER_SETTINGS``-dictionary in your settings file. Currently, the following options are supported:--**ALLOW_REGISTRATION**: Default ``True``.- Controls whether users can register on their own or if a gym administrator has- to create the user accounts.--**ALLOW_GUEST_USERS**: Default ``True``.- Controls whether users can use the site as a guest user or if an administrator- has to create the user accounts, as with the option above.--**USE_RECAPTCHA**: Default ``False``.- Controls whether a captcha challenge will be presented when new users register.--**REMOVE_WHITESPACE**: Default ``False``.- Removes whitespaces around HTML tags to reduce the size of the resulting HTML.- If you are not serving the site using TLS you probably want to use the GZip- middleware instead. Read the Django documentation on the security implications- (BREACH attack).--**EMAIL_FROM**: Default `wger Workout Manager <[email protected]>`- The sender address used for sent emails by the system such as weight reminders---.. note::- If you want to override a default setting, don't overwrite all the dictionary- but only the keys you need, e.g. ``WGER_SETTINGS['foo'] = 'bar'``. This avoids- problems when new keys are added in the global settings.--Set the URL for your site in the table ``django_site``. This is only used e.g. in-the password reset emails.diff --git a/docs/tips_and_tricks.rst b/docs/tips_and_tricks.rstdeleted file mode 100644index 1ac87210b..000000000--- a/docs/tips_and_tricks.rst+++ /dev/null@@ -1,117 +0,0 @@-.. _tips:--Tips and tricks------------------Clearing the cache-~~~~~~~~~~~~~~~~~~--Sometimes there are changes to the internal changes of the cached structures.-It is recommended that you just clear all the existing caches-``python manage.py clear-cache --clear-all`` or just set the timeout to something-like one second (in settings.py::-- CACHES = {- 'default': {- 'BACKEND': 'django.core.cache.backends.locmem.LocMemCache',- 'LOCATION': 'wger-cache',- 'TIMEOUT': 1- }- }--Miscellaneous settings-~~~~~~~~~~~~~~~~~~~~~~--The following settings can be very useful during development (add to your-settings.py):---**Setting the email backend**- Use the console backend, all sent emails will be printed to it::-- EMAIL_BACKEND = 'django.core.mail.backends.console.EmailBackend'--Dummy data generator-~~~~~~~~~~~~~~~~~~~~--To properly test the different parts of the application for usability or-performance, it is often very useful to have some data to work with. For this-reason, there is a dummy data generator script in-extras/dummy_generator/generator.py. It allows you to generate entries for-users, gyms, workouts, and logs. For detailed usage options do::-- python generator.py --help--Or for options for, e.g. user generation::-- python generator.py users --help--To get you started, you might want to invoke the script in the following way. This-will create 10 gyms and 300 users, randomly assigning them to a different gym. Each-user will have 20 workouts and each exercise in each workout 30 log entries as well-as 10 nutrition diary entries per day::-- python generator.py gyms 10- python generator.py users 300- python generator.py workouts 20- python generator.py logs 30- python generator.py sessions random- python generator.py weight 100- python generator.py nutrition 20- python generator.py nutrition-diary 10- python generator.py measurement 20--.. note::- All generated users have their username as a password.--.. note::- While it is possible to generate hundreds of users, gyms are more restricted and- you will probably get duplicate names if you generate more than a dozen.---Selectively running tests-~~~~~~~~~~~~~~~~~~~~~~~~~--If you do a ``python manage.py test`` you will run the complete testsuite, and-this can take a while. You can control which tests will be executed like this.--Test only the tests in the 'core' app::-- python manage.py test wger.core--Test only the tests in the 'test_user.py` file in the core app::-- python manage.py test wger.core.tests.test_user--Test only the tests in 'StatusUserTestCase' in the file 'test_user.py` file in-the core app::-- python manage.py test wger.core.tests.test_user.StatusUserTestCase---Using runserver_plus-~~~~~~~~~~~~~~~~~~~~--During development, you can use ``runserver_plus`` instead of the default Django-server as you can use an interactive debugger directly from the browser if an-exception occurs. It also accepts the same command-line options. For this just-install the following packages::-- pip install django_extensions werkzeug- python manage.py runserver_plus [options]---Contributing---------------* **Send pull requests**: for new code you want to share, please send pull- requests in GitHub. Sending patches by email or attaching them to an issue- means a lot more work. It's recommended that you work on a feature branch- when working on something, especially when it's something bigger. While many- people insist on rebasing before sending a pull request, it's not necessary.--* **Run the tests**: wger is proud to have a test coverage of over 90%. When you- implement something new, don't forget to run the testsuite and write appropriate- tests for the new code.--* **Code according to the coding style**: :ref:`codingstyle`diff --git a/docs/updating.rst b/docs/updating.rstdeleted file mode 100644index 186a99c4e..000000000--- a/docs/updating.rst+++ /dev/null@@ -1,47 +0,0 @@-.. _updating:--Updating the application-========================-To keep the application updated you need to regularly perform the following-steps well you pull from upstream.---Python dependencies-```````````````````-To install updated python dependencies::-- source /path/to/venv/bin/activate- python manage.py migrate---Upgrade the database-````````````````````````````````-There are regular changes and upgrades to the database schema (these may also-come from new versions of Django or the installed dependencies). If you start-your server and see a message that there are unapplied migrations, just do::-- python manage.py migrate --all--You might want to save a dump of the database before applying the migrations-in case something happens.---JS and CSS dependencies-````````````````````````````````-We use yarn to download the JS and CSS libraries. To update them just run-the following command on the source folder::-- yarn install- yarn build:css:sass- python manage.py collectstatic # only needed in production--Pull new data-`````````````--You can pull new exercise data and ingredients but remember that new ingredients-can overwrite the ones you added manually::-- python3 manage.py sync-exercises- python3 manage.py download-exercise-images- wger load-online-fixtures-diff --git a/requirements.txt b/requirements.txtindex 8640faf6c..4f2a8f640 100644--- a/requirements.txt+++ b/requirements.txt@@ -18,8 +18,6 @@ invoke~=1.6pillow~=8.4reportlab==3.6.5requests==2.27.1-setuptools>=18.5-sphinx==4.3.2# AWS#boto3