X-Git-Url: https://git.mdrn.pl/wolnelektury.git/blobdiff_plain/96390ae52c2017ae4fb9a61831beeb68c808a2f6..a5d97184b87b72f8fb964c862af0f54f3ef788c1:/README.md
diff --git a/README.md b/README.md
index 4127035eb..139cccc00 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,14 @@
+# Wolne Lektury
+
+![Wolne Lektury](src/wolnelektury/static/img/logo-bez.png)
+
+
+Wolne Lektury is a free internet library maintained by Modern Poland Foundation.
+
+It's a service based on [Django](https://www.djangoproject.com/), using
+[Librarian](https://git.mdrn.pl/librarian.git) to publish books in various formats.
+
+
License
-------
@@ -20,23 +31,23 @@ License
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
+
Dependencies
============
- * Python 2.7
+ * Python 3.5-3.7
* All packages listed in requirements.txt
- * Sass>=3.2
+
How to deploy (development version)
=============
-1. Checkout the source code from Github and enter the directory
+1. Checkout the source code from Git and enter the directory
2. Install libraries (we recommend using pip):
pip install -r requirements/requirements.txt
- git submodule update --init
-3. Setup your local configuration based on settings.py. You need to generate a new SECRET_KEY, database stuff and domain related stuff.
+3. Setup your local configuration in src/wolnelektury/localsettings.py. You need to generate a new SECRET_KEY, database stuff and domain related stuff.
4. Populate database:
./manage.py migrate
@@ -56,34 +67,31 @@ How to deploy (development version)
Translation strings are based on gettext and can be found under 'locale' dir.
There are also JavaScript files for jQuery countdown plugin (static/js/jquery.countdown-*.js).
+
Bundled software
================
* django-chunks
- in `apps/chunks`
+ in `src/chunks`
based on [django-chunks](http://code.google.com/p/django-chunks/)
by Clint Ecker ,
[New BSD License](http://www.opensource.org/licenses/bsd-license.php)
* [django-newtagging](http://www.bitbucket.org/zuber/django-newtagging/)
- in `apps/newtagging`
+ in `src/newtagging`
by Marek StÄpniowski ,
[MIT License](http://www.opensource.org/licenses/mit-license.php),
based on [django-tagging](http://code.google.com/p/django-tagging/), also under [MIT License](http://www.opensource.org/licenses/mit-license.php)
* [jPlayer](http://jplayer.org/)
- in `apps/catalogue/static/jplayer`
+ in `src/catalogue/static/jplayer`
by Happyworm,
[MIT License](http://opensource.org/licenses/MIT)
* [Switch template tag](http://djangosnippets.org/snippets/967/)
- in `apps/wolnelektury_core/templatetags/switch_tag.py`
+ in `src/wolnelektury/templatetags/switch_tag.py`
by adurdin
-* [Cropping engine for sorl-thumbnail](http://timmyomahony.com/blog/custom-cropping-engine-sorl-thumbnail/)
- in `apps/picture/engine.py`
- by Timmy O'Mahony
-* Javascript in `apps/wolnelektury_core/static/js/contrib`
+* Javascript in `src/wolnelektury/static/js/contrib`
with relevant attribution and licensing
-
Authors
=======
* Marek StÄpniowski