{ "info": { "author": "Ashley Felton", "author_email": "asi@dbca.wa.gov.au", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Web Environment", "Framework :: Django", "Framework :: Django :: 1.10", "Framework :: Django :: 1.11", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Topic :: Software Development :: Libraries", "Topic :: Software Development :: Libraries :: Python Modules" ], "description": "========================\nDBCA Django web template\n========================\n\nThis project consists of a basic Django application containing HTML\ntemplates that provide a starting point for web applications used by the\n`Department`_. The base template consists of a mobile-friendly\nHTML5 template with a fixed top navbar, plus static assets.\nThe project also contains functional examples of **login** and\n**logged out** templates.\n\nThe base template is based upon `HTML5 Boilerplate`_, and includes the\n`Bootstrap 3`_ CSS framework.\n\nInstallation\n============\n\n#. Install via pip: ``pip install webtemplate-dpaw``.\n#. Add ``'webtemplate_dpaw'`` to ``INSTALLED_APPS``.\n#. Ensure that the ``staticfiles`` application is included and configured\n correctly.\n#. Ensure that you have defined the following named URLs: ``login`` and\n ``logout`` (this requirement can be overriden, see below).\n#. Extend the included base template by placing the following at the head\n of your own templates: ``{% extends \"webtemplate_dpaw/base.html\" %}``\n#. Place page content within the required blocks (see below).\n\nIncluded CSS and JavaScript\n===========================\n\nThe base template currently includes the following CSS and JavaScript assets\n(served via the Department's internal mirror of `CDNJS`_):\n\n#. Modernizr 2.8.3 (HTML5 polyfills)\n#. Bootstrap 3.3.5 (CSS & JS)\n#. jQuery 2.1.4 (DOM traversal, etc.)\n\nAdditional styling can be included using the ``extra_style`` or ``extra_js``\nblocks, like so::\n\n {% load static from staticfiles %}\n\n {% block extra_style %}\n {{ block.super }}\n \n {% endblock %}\n\nYou can also overide the ``base_style`` and ``base_js`` blocks completely to\nuse different CSS or JS libraries. Note that you will also need to replace the\n``top_navbar`` block contents if you replace the base Bootstrap CSS & JS.\n\nTemplate blocks\n===============\n\nThe base template contains a number of block tags that are used to render the\ncontent of your project. The main template content blocks are as follows:\n\n- ``navbar_links`` - used to define navigation links in the top navbar.\n- ``navbar_auth`` - used to display either a **Login** or **Logout** link.\n- ``page_content`` - used to contain the page's main content.\n- ``page_footer`` - used to contain a page footer area.\n\nNote that the ``navbar_auth`` block contains ``{% url %}`` templatetags with\nnamed URLs called *login* and *logout*. If this is not required or\ninappropriate for your project, simply override the ``navbar_auth`` block.\n\nIn addition, a number of context variables are defined:\n\n- ``page_title`` - used to populate the page **
© 2015 Department of Parks and Wildlife
\n