X-Git-Url: https://git.mdrn.pl/redakcja.git/blobdiff_plain/a8ffbcfa8eed3032af4a7accec640a3cc424c842..9b533fdbfd08bd764744ae3a0d4717c87b61cf18:/README.md?ds=sidebyside diff --git a/README.md b/README.md index 40192622..58696533 100644 --- a/README.md +++ b/README.md @@ -1,44 +1,56 @@ -==================== -Platforma Redakcyjna -==================== +# Platforma Redakcyjna + + +## Opis projektu -Opis projektu -============= Platforma to serwis sÅuÅ¼Ä cy do grupowej edycji ksiÄ Å¼ek na potrzeby serwisu WolneLektury.pl. -Instalacja i użycie -=================== -#. Upewnij siÄ, że masz Pythona w wersji co najmniej 3.5. -#. Stwórz i uruchom wirtualne Årodowisko: - python3 -m venv ve - . ve/bin/activate +## Instalacja i użycie + +1. Upewnij siÄ, że masz Pythona w wersji co najmniej 3.5. +2. Stwórz i uruchom wirtualne Årodowisko: + +```bash +python3 -m venv ve +. ve/bin/activate +``` -#. Przejdź do katalogu serwisu w konsoli -#. Zainstaluj wymagane biblioteki komendÄ :: +3. Przejdź do katalogu serwisu w konsoli +4. Zainstaluj wymagane biblioteki komendÄ :: - pip install -r requirements/requirements.txt +```bash +pip install -r requirements/requirements.txt +``` -#. Skopiuj zawartoÅÄ pliku `src/redakcja/localsettings.sample` do `src/redakcja/localsettings.py` i zmieÅ go zgodnie ze swoimi potrzebami. +5. Skopiuj zawartoÅÄ pliku `src/redakcja/localsettings.sample` do `src/redakcja/localsettings.py` i zmieÅ go zgodnie ze swoimi potrzebami. -#. WypeÅnij bazÄ danych:: +6. WypeÅnij bazÄ danych:: - src/manage.py migrate +```bash +src/manage.py migrate +``` -#. Uruchom serwer deweloperski:: +7. Uruchom serwer deweloperski:: - src/manage.py runserver +```bash +src/manage.py runserver +``` -#. Strategie wdrożeniowe opisane sÄ w `Dokumentacji Django <http://docs.djangoproject.com/en/dev/howto/deployment/#howto-deployment-index>`_. +8. Strategie wdrożeniowe opisane sÄ w [Dokumentacji Django](http://docs.djangoproject.com/en/dev/howto/deployment/#howto-deployment-index>). + Do przygotowania wersji do wdrożenia możesz użyÄ komendy `make deploy`. -Testy -==== +## Testy - $ pip install -r requirements-test.txt - $ make test +```bash +pip install -r requirements-test.txt +make test +``` JavaScript (wymagany node.js i xsltproc): - $ npm install - $ ./node_modules/.bin/mocha -u tdd $(find src -name *_test.js) +```bash +npm install +./node_modules/.bin/mocha -u tdd $(find src -name *_test.js) +```