OpenStack Dashboard (Horizon)
Go to file
Diana Whitten 35706f5b6b Sidebar now inherits from a Bootstrap Theme
Horizon's sidebar now uses .nav and implements a nav using
.nav-stacked and .nav-pills to support a standard Bootstrap theme.
It was also simplfied to use Bootstrap's built in accordion
functionality and therefore removes all of the javascript required to
duplicate this experience.  There was also a small glitchy experience
with the custom accordion code, this is now solved with Bootstrap.

All highly customized style elements that were specific to the 'default'
theme were moved into the theme folder itself.  Only the styles
necessary to conform standard Bootstrap remain in the dashboard
directory tree.

The sidebar was formerly named an 'accordion-nav', but this name is
coupled with the presentational experience that is implemented within
the sidebar. Therefore, sidebar is more semantic than accordion.
Because it is now simple to override the sidebar with a non-accordion
experience, we should just call it the sidebar going forward.

sidebar-bg.png was removed as it was only limiting the ability to
easily grow the size of the sidebar.  It was providing a box-shadow
which can be done with pure css.

To test and use this functionality, clean your static directory, then
run collectstatic and compress prior to starting your server.

Partially-Implements: blueprint horizon-theme-css-reorg
Partially-Implements: blueprint bootstrap-html-standards
Change-Id: Ic7fcde7dd82e70815dc7fcae04bc9ae9d618d4d8
2015-08-11 15:01:56 -07:00
.tx Remove now obsolete English po files, update run_tests 2015-06-22 20:17:55 +02:00
doc Merge "comment and version update for DEFAULT_THEME_PATH" 2015-08-07 02:55:07 +00:00
horizon Sidebar now inherits from a Bootstrap Theme 2015-08-11 15:01:56 -07:00
openstack_dashboard Sidebar now inherits from a Bootstrap Theme 2015-08-11 15:01:56 -07:00
tools Angular translation via babel (singular only) 2015-07-02 11:13:45 +10:00
.eslintignore Added .eslintignore 2015-07-02 08:29:08 -07:00
.eslintrc Use eslint-config-openstack 2015-07-15 13:36:55 -07:00
.gitignore Get unit tests working with Karma 2015-06-01 14:14:58 +00:00
.gitreview Add .gitreview and rfc.sh. 2011-10-28 09:50:35 -04:00
.mailmap Update my mailmap 2013-10-25 14:49:23 +08:00
.pylintrc updating run_tests.sh to mimic other openstack projects, pep8, pylint, coverage 2011-08-31 14:41:36 -07:00
babel-django.cfg Replace makemessages with babel 2015-06-22 09:44:12 -07:00
babel-djangojs.cfg Angular translation via babel (singular only) 2015-07-02 11:13:45 +10:00
CONTRIBUTING.rst Workflow documentation is now in infra-manual 2014-12-05 03:30:36 +00:00
HACKING.rst Remove #noqa from django.conf.urls.include 2014-09-29 13:58:39 +04:00
LICENSE Initial commit 2011-01-12 13:43:31 -08:00
Makefile Unifies the project packaging into one set of modules. 2012-02-29 00:20:13 -08:00
manage.py Gate on H102 Apache 2.0 license header not found for pep8 2013-11-19 13:55:04 -05:00
MANIFEST.in Drop NodeJS dependency in favor of pure-python lesscpy 2013-08-16 09:31:08 +02:00
package.json Use eslint-config-openstack 2015-07-15 13:36:55 -07:00
README.rst Add install guide for users and clean up README 2014-10-09 03:29:26 +09:00
requirements.txt Updated from global requirements 2015-08-10 01:06:17 +00:00
run_tests.sh Duplicate keywords for translation 2015-07-07 13:07:24 -07:00
setup.cfg Update version for Liberty 2015-06-17 21:51:51 +00:00
setup.py Updated from global requirements 2015-07-15 21:21:49 +00:00
test-requirements.txt Updated from global requirements 2015-07-23 12:49:56 +00:00
test-shim.js Fix bug where WEBROOT is not respected 2015-07-22 04:10:50 +00:00
tox.ini Removed JSHint 2015-07-01 09:11:21 -07:00

Horizon (OpenStack Dashboard)

Horizon is a Django-based project aimed at providing a complete OpenStack Dashboard along with an extensible framework for building new dashboards from reusable components. The openstack_dashboard module is a reference implementation of a Django site that uses the horizon app to provide web-based interactions with the various OpenStack projects.

Using Horizon

See doc/source/topics/install.rst about how to install Horizon in your OpenStack setup. It describes the example steps and has pointers for more detailed settings and configurations.

It is also available at http://docs.openstack.org/developer/horizon/topics/install.html.

Getting Started for Developers

doc/source/quickstart.rst or http://docs.openstack.org/developer/horizon/quickstart.html describes how to setup Horizon development environment and start development.

Building Contributor Documentation

This documentation is written by contributors, for contributors.

The source is maintained in the doc/source directory using reStructuredText and built by Sphinx

  • Building Automatically:

    $ ./run_tests.sh --docs
  • Building Manually:

    $ tools/with_venv.sh sphinx-build doc/source doc/build/html

Results are in the doc/build/html directory