|
|
@@ -4,7 +4,7 @@ Overview
|
|
|
|
|
|
Welcome to Misago documentation!
|
|
|
|
|
|
-Misago is internet forum solution with many features aimed at different kinds of users. The aim for documentation is to provide refence and explanation of features available for them, allowing them to complete their taks better and more effectively.
|
|
|
+Misago is internet forum solution with many features aimed at different kinds of users. The aim of this documentation is to provide refence and explanation of features available for them, allowing them to complete their taks better and more effectively.
|
|
|
|
|
|
.. warning::
|
|
|
Work on documentation has only just begun and currently all efford is focused exclusively on developer oriented subjects.
|
|
|
@@ -38,18 +38,24 @@ Misago is being developed with customizability and extensibility on mind and off
|
|
|
|
|
|
And if this isn't enough for you, Misago itself stands on shoulders of `Django <https://www.djangoproject.com/>`_, powerful and battle-tested web framework with great documentation and rich ecosystem of additional modules (named "apps"). This means Misago is not "just forum solution". Its also complete framework you may use to build your entire site around, writing your own Django apps or installing and adapting one of thousands ready apps freely available in the internet.
|
|
|
|
|
|
+No matter what you are trying to accomplish, Misago has you covered.
|
|
|
+
|
|
|
|
|
|
Customizing Appearance
|
|
|
----------------------
|
|
|
|
|
|
+Misago appearance is product of many different technologies acting together to produce final result that you and your users see in their browsers.
|
|
|
+
|
|
|
+On server side powerful, performant and extensible template engine named `Jinja2 <http://jinja.pocoo.org/>`_ turns template files into final html that is displayed in browser while asset pipeline compiles, merges and optimizes less, css and javascript files making your browser load faster and relieving you from burden of compressing and optimizing them yourself.
|
|
|
|
|
|
+On browder side Misago comes with it's own UI framework that uses `Bootstrap <http://getbootstrap.com>`_, `jQuery <http://jquery.org>`_ as well Glyphicons and `Font Awesome <http://fontawesome.io>`_ as it's foundations that allows you to provide smooth, pleasant and modern experience to your site's users.
|
|
|
|
|
|
|
|
|
Writing Extensions
|
|
|
------------------
|
|
|
|
|
|
+Misago extensions are called "apps". Each "app" can be either single feature like, say, extra user profile tab, or entire set of many features working together to add whole new part to your site, like user blogs or galleries or portal.
|
|
|
|
|
|
-Understanding Internals
|
|
|
------------------------
|
|
|
-
|
|
|
+To offer such level of extensibility many parts of Misago (and Django too!) were designed as simple and lightweight frameworks to which that you can add (or remove) features.
|
|
|
|
|
|
+Following references cover everything you want to know about writing your own apps for Misago. From them you will learn what coding style, conventions and best practices you should follow when writing your code. Next you will be shown how to add your own pages and models to Misago and what features are available for you in doing so. Finally all available frameworks will be presented with explanation what they are used for and how you can add your features to them.
|
Rafał Pitoń