#, fuzzy msgid "" msgstr "" "Project-Id-Version: horizon 13.0.2.dev34\n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2019-04-15 10:18-0500\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #: ../../source/configuration/branding.rst:3 msgid "Branding Horizon" msgstr "" #: ../../source/configuration/branding.rst:5 msgid "" "As of the Liberty release, Horizon has begun to conform more strictly to " "Bootstrap standards in an effort to embrace more responsive web design as " "well as alleviate the future need to re-brand new functionality for every " "release." msgstr "" #: ../../source/configuration/branding.rst:10 msgid "Supported Components" msgstr "" #: ../../source/configuration/branding.rst:11 msgid "" "The following components, organized by release, are the only ones that make " "full use of the Bootstrap theme architecture." msgstr "" #: ../../source/configuration/branding.rst:14 msgid "8.0.0 (Liberty)" msgstr "" #: ../../source/configuration/branding.rst:16 msgid "`Top Navbar`_" msgstr "" #: ../../source/configuration/branding.rst:17 msgid "`Side Nav`_" msgstr "" #: ../../source/configuration/branding.rst:18 msgid "`Pie Charts`_" msgstr "" #: ../../source/configuration/branding.rst:20 msgid "9.0.0 (Mitaka)" msgstr "" #: ../../source/configuration/branding.rst:22 msgid "Tables_" msgstr "" #: ../../source/configuration/branding.rst:23 msgid "`Bar Charts`_" msgstr "" #: ../../source/configuration/branding.rst:24 msgid "Login_" msgstr "" #: ../../source/configuration/branding.rst:25 msgid "Tabs_" msgstr "" #: ../../source/configuration/branding.rst:26 msgid "Alerts_" msgstr "" #: ../../source/configuration/branding.rst:27 msgid "Checkboxes_" msgstr "" #: ../../source/configuration/branding.rst:30 msgid "Step 1" msgstr "" #: ../../source/configuration/branding.rst:32 msgid "" "The first step needed to create a custom branded theme for Horizon is to " "create a custom Bootstrap theme. There are several tools to aid in this. " "Some of the more useful ones include:" msgstr "" #: ../../source/configuration/branding.rst:36 msgid "`Bootswatchr`_" msgstr "" #: ../../source/configuration/branding.rst:37 msgid "`Paintstrap`_" msgstr "" #: ../../source/configuration/branding.rst:38 msgid "`Bootstrap`_" msgstr "" #: ../../source/configuration/branding.rst:42 msgid "" "Bootstrap uses LESS by default, but we use SCSS. All of the above tools " "will provide the ``variables.less`` file, which will need to be converted to " "``_variables.scss``" msgstr "" #: ../../source/configuration/branding.rst:47 msgid "Top Navbar" msgstr "" #: ../../source/configuration/branding.rst:49 msgid "" "The top navbar in Horizon now uses a native Bootstrap ``navbar``. There are " "a number of variables that can be used to customize this element. Please " "see the **Navbar** section of your variables file for specifics on what can " "be set: any variables that use ``navbar-default``." msgstr "" #: ../../source/configuration/branding.rst:54 msgid "" "It is important to also note that the navbar now uses native Bootstrap " "dropdowns, which are customizable with variables. Please see the " "**Dropdowns** section of your variables file." msgstr "" #: ../../source/configuration/branding.rst:58 msgid "" "The top navbar is now responsive on smaller screens. When the window size " "hits your ``$screen-sm`` value, the topbar will compress into a design that " "is better suited for small screens." msgstr "" #: ../../source/configuration/branding.rst:63 msgid "Side Nav" msgstr "" #: ../../source/configuration/branding.rst:65 msgid "" "The side navigation component has been refactored to use the native Stacked " "Pills element from Bootstrap. See **Pills** section of your variables file " "for specific variables to customize." msgstr "" #: ../../source/configuration/branding.rst:70 msgid "Charts" msgstr "" #: ../../source/configuration/branding.rst:73 msgid "Pie Charts" msgstr "" #: ../../source/configuration/branding.rst:75 msgid "" "Pie Charts are SVG elements. SVG elements allow CSS customizations for only " "a basic element's look and feel (i.e. colors, size)." msgstr "" #: ../../source/configuration/branding.rst:78 msgid "" "Since there is no native element in Bootstrap specifically for pie charts, " "the look and feel of the charts are inheriting from other elements of the " "theme. Please see ``_pie_charts.scss`` for specifics." msgstr "" #: ../../source/configuration/branding.rst:85 msgid "Bar Charts" msgstr "" #: ../../source/configuration/branding.rst:87 msgid "" "Bar Charts can be either a Bootstrap Progress Bar or an SVG element. Either " "implementation will use the Bootstrap Progress Bar styles." msgstr "" #: ../../source/configuration/branding.rst:90 msgid "" "The SVG implementation will not make use of the customized Progress Bar " "height though, so it is recommended that Bootstrap Progress Bars are used " "whenever possible." msgstr "" #: ../../source/configuration/branding.rst:94 msgid "" "Please see ``_bar_charts.scss`` for specifics on what can be customized for " "SVGs. See the **Progress bars** section of your variables file for specific " "variables to customize." msgstr "" #: ../../source/configuration/branding.rst:99 msgid "Tables" msgstr "" #: ../../source/configuration/branding.rst:101 msgid "" "The standard Django tables now make use of the native Bootstrap table markup." " See **Tables** section of your variables file for variables to customize." msgstr "" #: ../../source/configuration/branding.rst:104 msgid "" "The standard Bootstrap tables will be borderless by default. If you wish to " "add a border, like the ``default`` theme, see ``openstack_dashboard/themes/" "default/horizon/components/_tables.scss``" msgstr "" #: ../../source/configuration/branding.rst:111 msgid "Login" msgstr "" #: ../../source/configuration/branding.rst:114 msgid "Login Splash Page" msgstr "" #: ../../source/configuration/branding.rst:116 msgid "" "The login splash page now uses a standard Bootstrap panel in its " "implementation. See the **Panels** section in your variables file to " "variables to easily customize." msgstr "" #: ../../source/configuration/branding.rst:121 msgid "Modal Login" msgstr "" #: ../../source/configuration/branding.rst:123 msgid "" "The modal login experience, as used when switching regions, uses a standard " "Bootstrap dialog. See the **Modals** section of your variables file for " "specific variables to customize." msgstr "" #: ../../source/configuration/branding.rst:128 msgid "Tabs" msgstr "" #: ../../source/configuration/branding.rst:130 msgid "The standard tabs make use of the native Bootstrap tab markup." msgstr "" #: ../../source/configuration/branding.rst:132 msgid "" "See **Tabs** section of your variables file for variables to customize." msgstr "" #: ../../source/configuration/branding.rst:135 msgid "Alerts" msgstr "" #: ../../source/configuration/branding.rst:137 msgid "" "Alerts use the basic Bootstrap brand colors. See **Colors** section of your " "variables file for specifics." msgstr "" #: ../../source/configuration/branding.rst:141 msgid "Checkboxes" msgstr "" #: ../../source/configuration/branding.rst:143 msgid "" "Horizon uses icon fonts to represent checkboxes. In order to customize " "this, you simply need to override the standard scss. For an example of " "this, see themes/material/static/horizon/components/_checkboxes.scss" msgstr "" #: ../../source/configuration/branding.rst:148 msgid "Bootswatch and Material Design" msgstr "" #: ../../source/configuration/branding.rst:150 msgid "" "`Bootswatch`_ is a collection of free themes for Bootstrap and is now " "available for use in Horizon." msgstr "" #: ../../source/configuration/branding.rst:153 msgid "" "In order to showcase what can be done to enhance an existing Bootstrap " "theme, Horizon now includes a secondary theme, roughly based on `Google's " "Material Design`_ called ``material``. Bootswatch's **Paper** is a simple " "Bootstrap implementation of Material Design and is used by ``material``." msgstr "" #: ../../source/configuration/branding.rst:158 msgid "" "Bootswatch provides a number of other themes, that once Horizon is fully " "theme compliant, will allow easy toggling and customizations for darker or " "accessibility driven experiences." msgstr "" #: ../../source/configuration/branding.rst:163 msgid "Development Tips" msgstr "" #: ../../source/configuration/branding.rst:165 msgid "" "When developing a new theme for Horizon, it is required that the dynamically " "generated `static` directory be cleared after each change and the server " "restarted. This is not always ideal. If you wish to develop and not have " "to restart the server each time, it is recommended that you configure your " "development environment to not run in OFFLINE mode. Simply verify the " "following settings in your local_settings.py::" msgstr "" #: ../../source/configuration/customizing.rst:5 msgid "Customizing Horizon" msgstr "" #: ../../source/configuration/customizing.rst:9 msgid "You may also be interested in :doc:`themes` and :doc:`branding`." msgstr "" #: ../../source/configuration/customizing.rst:12 msgid "Changing the Site Title" msgstr "" #: ../../source/configuration/customizing.rst:14 msgid "" "The OpenStack Dashboard Site Title branding (i.e. \"**OpenStack** " "Dashboard\") can be overwritten by adding the attribute ``SITE_BRANDING`` to " "``local_settings.py`` with the value being the desired name." msgstr "" #: ../../source/configuration/customizing.rst:18 msgid "" "The file ``local_settings.py`` can be found at the Horizon directory path of " "``openstack_dashboard/local/local_settings.py``." msgstr "" #: ../../source/configuration/customizing.rst:22 msgid "Changing the Brand Link" msgstr "" #: ../../source/configuration/customizing.rst:24 msgid "" "The logo also acts as a hyperlink. The default behavior is to redirect to " "``horizon:user_home``. By adding the attribute ``SITE_BRANDING_LINK`` with " "the desired url target e.g., ``http://sample-company.com`` in " "``local_settings.py``, the target of the hyperlink can be changed." msgstr "" #: ../../source/configuration/customizing.rst:30 msgid "Customizing the Footer" msgstr "" #: ../../source/configuration/customizing.rst:32 msgid "" "It is possible to customize the global and login footers using a theme's " "template override. Simply add ``_footer.html`` for a global footer override " "or ``_login_footer.html`` for the login page's footer to your theme's " "template directory." msgstr "" #: ../../source/configuration/customizing.rst:38 msgid "Modifying Existing Dashboards and Panels" msgstr "" #: ../../source/configuration/customizing.rst:40 msgid "" "If you wish to alter dashboards or panels which are not part of your " "codebase, you can specify a custom python module which will be loaded after " "the entire Horizon site has been initialized, but prior to the URLconf " "construction. This allows for common site-customization requirements such as:" "" msgstr "" #: ../../source/configuration/customizing.rst:45 msgid "Registering or unregistering panels from an existing dashboard." msgstr "" #: ../../source/configuration/customizing.rst:46 msgid "Changing the names of dashboards and panels." msgstr "" #: ../../source/configuration/customizing.rst:47 msgid "Re-ordering panels within a dashboard or panel group." msgstr "" #: ../../source/configuration/customizing.rst:49 msgid "" "Default Horizon panels are loaded based upon files within the " "openstack_dashboard/enabled/ folder. These files are loaded based upon the " "filename order, with space left for more files to be added. There are some " "example files available within this folder, with the .example suffix added. " "Developers and deployers should strive to use this method of customization " "as much as possible, and support for this is given preference over more " "exotic methods such as monkey patching and overrides files." msgstr "" #: ../../source/configuration/customizing.rst:60 msgid "Horizon customization module (overrides)" msgstr "" #: ../../source/configuration/customizing.rst:62 msgid "" "Horizon has a global overrides mechanism available to perform customizations " "that are not yet customizable via configuration settings. This file can " "perform monkey patching and other forms of customization which are not " "possible via the enabled folder's customization method." msgstr "" #: ../../source/configuration/customizing.rst:67 msgid "" "This method of customization is meant to be available for deployers of " "Horizon, and use of this should be avoided by Horizon plugins at all cost. " "Plugins needing this level of monkey patching and flexibility should instead " "look for changing their __init__.py file and performing customizations " "through other means." msgstr "" #: ../../source/configuration/customizing.rst:73 msgid "" "To specify the python module containing your modifications, add the key " "``customization_module`` to your ``HORIZON_CONFIG`` dictionary in " "``local_settings.py``. The value should be a string containing the path to " "your module in dotted python path notation. Example::" msgstr "" #: ../../source/configuration/customizing.rst:80 msgid "" "You can do essentially anything you like in the customization module. For " "example, you could change the name of a panel::" msgstr "" #: ../../source/configuration/customizing.rst:92 msgid "Or get the instances panel::" msgstr "" #: ../../source/configuration/customizing.rst:97 msgid "Or just remove it entirely::" msgstr "" #: ../../source/configuration/customizing.rst:101 msgid "" "You cannot unregister a ``default_panel``. If you wish to remove a " "``default_panel``, you need to make a different panel in the dashboard as a " "``default_panel`` and then unregister the former. For example, if you wished " "to remove the ``overview_panel`` from the ``Project`` dashboard, you could " "do the following::" msgstr "" #: ../../source/configuration/customizing.rst:112 msgid "You can also override existing methods with your own versions::" msgstr "" #: ../../source/configuration/customizing.rst:123 msgid "" "You could also customize what columns are displayed in an existing table, by " "redefining the ``columns`` attribute of its ``Meta`` class. This can be " "achieved in 3 steps:" msgstr "" #: ../../source/configuration/customizing.rst:127 msgid "Extend the table that you wish to modify" msgstr "" #: ../../source/configuration/customizing.rst:128 msgid "" "Redefine the ``columns`` attribute under the ``Meta`` class for this new " "table" msgstr "" #: ../../source/configuration/customizing.rst:130 msgid "" "Modify the ``table_class`` attribute for the related view so that it points " "to the new table" msgstr "" #: ../../source/configuration/customizing.rst:134 msgid "" "For example, if you wished to remove the Admin State column from the :class:" "`~openstack_dashboard.dashboards.admin.networks.tables.NetworksTable`, you " "could do the following::" msgstr "" #: ../../source/configuration/customizing.rst:148 msgid "" "If you want to add a column you can override the parent table in a similar " "way, add the new column definition and then use the ``Meta`` ``columns`` " "attribute to control the column order as needed." msgstr "" #: ../../source/configuration/customizing.rst:154 msgid "" "``my_project.overrides`` needs to be importable by the python process " "running Horizon. If your module is not installed as a system-wide python " "package, you can either make it installable (e.g., with a setup.py) or you " "can adjust the python path used by your WSGI server to include its location." msgstr "" #: ../../source/configuration/customizing.rst:160 msgid "" "Probably the easiest way is to add a ``python-path`` argument to the " "``WSGIDaemonProcess`` line in Apache's Horizon config." msgstr "" #: ../../source/configuration/customizing.rst:163 msgid "" "Assuming your ``my_project`` module lives in ``/opt/python/my_project``, " "you'd make it look like the following::" msgstr "" #: ../../source/configuration/customizing.rst:170 msgid "Customize the project and user table columns" msgstr "" #: ../../source/configuration/customizing.rst:173 msgid "" "Keystone V3 has a place to store extra information regarding project and " "user. Using the override mechanism described in :ref:`horizon-customization-" "module`, Horizon is able to show these extra information as a custom column. " "For example, if a user in Keystone has an attribute ``phone_num``, you could " "define new column::" msgstr "" #: ../../source/configuration/customizing.rst:199 msgid "Customize Angular dashboards" msgstr "" #: ../../source/configuration/customizing.rst:201 msgid "" "In Angular, you may write a plugin to extend certain features. Two " "components in the Horizon framework that make this possible are the " "extensibility service and the resource type registry service. The " "``extensibleService`` allows certain Horizon elements to be extended " "dynamically, including add, remove, and replace. The " "``resourceTypeRegistry`` service provides methods to set and get information " "pertaining to a resource type object. We use Heat type names like ``OS::" "Glance::Image`` as our reference name." msgstr "" #: ../../source/configuration/customizing.rst:209 msgid "Some information you may place in the registry include:" msgstr "" #: ../../source/configuration/customizing.rst:211 msgid "API to fetch data from" msgstr "" #: ../../source/configuration/customizing.rst:212 msgid "Property names" msgstr "" #: ../../source/configuration/customizing.rst:213 msgid "Actions (e.g. \"Create Volume\")" msgstr "" #: ../../source/configuration/customizing.rst:214 msgid "URL paths to detail view or detail drawer" msgstr "" #: ../../source/configuration/customizing.rst:215 msgid "Property information like labels or formatting for property values" msgstr "" #: ../../source/configuration/customizing.rst:217 msgid "" "These properties in the registry use the extensibility service (as of Newton " "release):" msgstr "" #: ../../source/configuration/customizing.rst:220 msgid "globalActions" msgstr "" #: ../../source/configuration/customizing.rst:221 msgid "batchActions" msgstr "" #: ../../source/configuration/customizing.rst:222 msgid "itemActions" msgstr "" #: ../../source/configuration/customizing.rst:223 msgid "detailViews" msgstr "" #: ../../source/configuration/customizing.rst:224 msgid "tableColumns" msgstr "" #: ../../source/configuration/customizing.rst:225 msgid "filterFacets" msgstr "" #: ../../source/configuration/customizing.rst:227 msgid "" "Using the information from the registry, we can build out our dashboard " "panels. Panels use the high-level directive ``hzResourceTable`` that " "replaces common templates so we do not need to write boilerplate HTML and " "controller code. It gives developers a quick way to build a new table or " "change an existing table." msgstr "" #: ../../source/configuration/customizing.rst:234 msgid "" "You may still choose to use the HTML template for complete control of form " "and functionality. For example, you may want to create a custom footer. You " "may also use the ``hzDynamicTable`` directive (what ``hzResourceTable`` uses " "under the hood) directly. However, neither of these is extensible. You would " "need to override the panel completely." msgstr "" #: ../../source/configuration/customizing.rst:240 msgid "" "This is a sample module file to demonstrate how to make some customizations " "to the Images Panel.::" msgstr "" #: ../../source/configuration/customizing.rst:292 msgid "" "Additionally, you should have content defined in ``detail.html`` and " "``drawer.html``, as well as define the ``surpriseService`` which is based " "off the ``actions`` directive and needs allowed and perform methods defined." msgstr "" #: ../../source/configuration/customizing.rst:298 msgid "Icons" msgstr "" #: ../../source/configuration/customizing.rst:300 msgid "" "Horizon uses font icons from Font Awesome. Please see `Font Awesome`_ for " "instructions on how to use icons in the code." msgstr "" #: ../../source/configuration/customizing.rst:303 msgid "To add icon to Table Action, use icon property. Example:" msgstr "" #: ../../source/configuration/customizing.rst:312 msgid "" "Additionally, the site-wide default button classes can be configured by " "setting ``ACTION_CSS_CLASSES`` to a tuple of the classes you wish to appear " "on all action buttons in your ``local_settings.py`` file." msgstr "" #: ../../source/configuration/customizing.rst:318 msgid "Custom Stylesheets" msgstr "" #: ../../source/configuration/customizing.rst:320 msgid "" "It is possible to define custom stylesheets for your dashboards. Horizon's " "base template ``openstack_dashboard/templates/base.html`` defines multiple " "blocks that can be overridden." msgstr "" #: ../../source/configuration/customizing.rst:324 msgid "" "To define custom css files that apply only to a specific dashboard, create a " "base template in your dashboard's templates folder, which extends Horizon's " "base template e.g. ``openstack_dashboard/dashboards/my_custom_dashboard/ " "templates/my_custom_dashboard/base.html``." msgstr "" #: ../../source/configuration/customizing.rst:329 msgid "" "In this template, redefine ``block css``. (Don't forget to include " "``_stylesheets.html`` which includes all Horizon's default stylesheets.)::" msgstr "" #: ../../source/configuration/customizing.rst:343 msgid "" "The custom stylesheets then reside in the dashboard's own ``static`` folder " "``openstack_dashboard/dashboards/my_custom_dashboard/static/ " "my_custom_dashboard/scss/my_custom_dashboard.scss``." msgstr "" #: ../../source/configuration/customizing.rst:347 msgid "All dashboard's templates have to inherit from dashboard's base.html::" msgstr "" #: ../../source/configuration/customizing.rst:354 msgid "Custom Javascript" msgstr "" #: ../../source/configuration/customizing.rst:356 msgid "" "Similarly to adding custom styling (see above), it is possible to include " "custom javascript files." msgstr "" #: ../../source/configuration/customizing.rst:359 msgid "" "All Horizon's javascript files are listed in the ``openstack_dashboard/ " "templates/horizon/_scripts.html`` partial template, which is included in " "Horizon's base template in ``block js``." msgstr "" #: ../../source/configuration/customizing.rst:363 msgid "" "To add custom javascript files, create an ``_scripts.html`` partial template " "in your dashboard ``openstack_dashboard/dashboards/my_custom_dashboard/ " "templates/my_custom_dashboard/_scripts.html`` which extends ``horizon/" "_scripts.html``. In this template override the ``block custom_js_files`` " "including your custom javascript files::" msgstr "" #: ../../source/configuration/customizing.rst:376 msgid "" "In your dashboard's own base template ``openstack_dashboard/dashboards/ " "my_custom_dashboard/templates/my_custom_dashboard/base.html`` override " "``block js`` with inclusion of dashboard's own ``_scripts.html``::" msgstr "" #: ../../source/configuration/customizing.rst:384 msgid "" "The result is a single compressed js file consisting both Horizon and " "dashboard's custom scripts." msgstr "" #: ../../source/configuration/customizing.rst:387 msgid "" "Additionally, some marketing and analytics scripts require you to place them " "within the page's tag. To do this, place them within the ``horizon/" "_custom_head_js.html`` file. Similar to the ``_scripts.html`` file mentioned " "above, you may link to an existing file::" msgstr "" #: ../../source/configuration/customizing.rst:394 msgid "" "or you can paste your script directly in the file, being sure to use " "appropriate tags::" msgstr "" #: ../../source/configuration/customizing.rst:403 msgid "Customizing Meta Attributes" msgstr "" #: ../../source/configuration/customizing.rst:405 msgid "" "To add custom metadata attributes to your project's base template, include " "them in the ``horizon/_custom_meta.html`` file. The contents of this file " "will be inserted into the page's just after the default Horizon meta " "tags." msgstr "" #: ../../source/configuration/index.rst:3 msgid "Configuration Guide" msgstr "" #: ../../source/configuration/pluggable_panels.rst:5 msgid "Pluggable Panels and Groups" msgstr "" #: ../../source/configuration/pluggable_panels.rst:8 #: ../../source/configuration/settings.rst:8 msgid "Introduction" msgstr "" #: ../../source/configuration/pluggable_panels.rst:10 msgid "" "Horizon allows dashboards, panels and panel groups to be added without " "modifying the default settings. Pluggable settings are a mechanism to allow " "settings to be stored in separate files. Those files are read at startup " "and used to modify the default settings." msgstr "" #: ../../source/configuration/pluggable_panels.rst:15 msgid "" "The default location for the dashboard configuration files is " "``openstack_dashboard/enabled``, with another directory, " "``openstack_dashboard/local/enabled`` for local overrides. Both sets of " "files will be loaded, but the settings in ``openstack_dashboard/local/" "enabled`` will overwrite the default ones. The settings are applied in " "alphabetical order of the filenames. If the same dashboard has configuration " "files in ``enabled`` and ``local/enabled``, the local name will be used. " "Note, that since names of python modules can't start with a digit, the files " "are usually named with a leading underscore and a number, so that you can " "control their order easily." msgstr "" #: ../../source/configuration/pluggable_panels.rst:26 msgid "General Pluggbale Settings" msgstr "" #: ../../source/configuration/pluggable_panels.rst:28 msgid "" "Before we describe the specific use cases, the following keys can be used in " "any pluggable settings file:" msgstr "" #: ../../source/configuration/pluggable_panels.rst:32 msgid "``ADD_EXCEPTIONS``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:36 msgid "" "A dictionary of exception classes to be added to ``HORIZON['exceptions']``." msgstr "" #: ../../source/configuration/pluggable_panels.rst:39 msgid "``ADD_INSTALLED_APPS``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:43 msgid "" "A list of applications to be prepended to ``INSTALLED_APPS``. This is needed " "to expose static files from a plugin." msgstr "" #: ../../source/configuration/pluggable_panels.rst:47 msgid "``ADD_ANGULAR_MODULES``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:51 #: ../../source/configuration/settings.rst:339 msgid "" "A list of AngularJS modules to be loaded when Angular bootstraps. These " "modules are added as dependencies on the root Horizon application " "``horizon``." msgstr "" #: ../../source/configuration/pluggable_panels.rst:55 msgid "``ADD_JS_FILES``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:59 msgid "" "A list of javascript source files to be included in the compressed set of " "files that are loaded on every page. This is needed for AngularJS modules " "that are referenced in ``ADD_ANGULAR_MODULES`` and therefore need to be " "included in every page." msgstr "" #: ../../source/configuration/pluggable_panels.rst:65 msgid "``ADD_JS_SPEC_FILES``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:69 #: ../../source/configuration/settings.rst:431 msgid "" "A list of javascript spec files to include for integration with the Jasmine " "spec runner. Jasmine is a behavior-driven development framework for testing " "JavaScript code." msgstr "" #: ../../source/configuration/pluggable_panels.rst:74 msgid "``ADD_SCSS_FILES``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:78 msgid "" "A list of scss files to be included in the compressed set of files that are " "loaded on every page. We recommend one scss file per dashboard, use @import " "if you need to include additional scss files for panels." msgstr "" #: ../../source/configuration/pluggable_panels.rst:85 msgid "``AUTO_DISCOVER_STATIC_FILES``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:89 msgid "" "If set to ``True``, JavaScript files and static angular html template files " "will be automatically discovered from the `static` folder in each apps " "listed in ADD_INSTALLED_APPS." msgstr "" #: ../../source/configuration/pluggable_panels.rst:93 msgid "" "JavaScript source files will be ordered based on naming convention: files " "with extension `.module.js` listed first, followed by other JavaScript " "source files." msgstr "" #: ../../source/configuration/pluggable_panels.rst:96 msgid "" "JavaScript files for testing will also be ordered based on naming convention:" " files with extension `.mock.js` listed first, followed by files with " "extension `.spec.js`." msgstr "" #: ../../source/configuration/pluggable_panels.rst:100 msgid "" "If ADD_JS_FILES and/or ADD_JS_SPEC_FILES are also specified, files manually " "listed there will be appended to the auto-discovered files." msgstr "" #: ../../source/configuration/pluggable_panels.rst:104 msgid "``DISABLED``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:108 msgid "" "If set to ``True``, this settings file will not be added to the settings." msgstr "" #: ../../source/configuration/pluggable_panels.rst:111 msgid "``UPDATE_HORIZON_CONFIG``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:115 msgid "" "A dictionary of values that will replace the values in ``HORIZON_CONFIG``." msgstr "" #: ../../source/configuration/pluggable_panels.rst:119 msgid "Pluggable Settings for Dashboards" msgstr "" #: ../../source/configuration/pluggable_panels.rst:123 msgid "The following keys are specific to registering a dashboard:" msgstr "" #: ../../source/configuration/pluggable_panels.rst:127 msgid "``DASHBOARD``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:131 msgid "" "The slug of the dashboard to be added to ``HORIZON['dashboards']``. Required." "" msgstr "" #: ../../source/configuration/pluggable_panels.rst:134 msgid "``DEFAULT``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:138 msgid "" "If set to ``True``, this dashboard will be set as the default dashboard." msgstr "" #: ../../source/configuration/pluggable_panels.rst:142 #: ../../source/configuration/pluggable_panels.rst:220 #: ../../source/configuration/pluggable_panels.rst:281 msgid "Examples" msgstr "" #: ../../source/configuration/pluggable_panels.rst:144 msgid "" "To disable a dashboard locally, create a file ``openstack_dashboard/local/" "enabled/_40_dashboard-name.py`` with the following content::" msgstr "" #: ../../source/configuration/pluggable_panels.rst:151 msgid "" "To add a Tuskar-UI (Infrastructure) dashboard, you have to install it, and " "then create a file ``openstack_dashboard/local/enabled/_50_tuskar.py`` with::" "" msgstr "" #: ../../source/configuration/pluggable_panels.rst:168 msgid "Pluggable Settings for Panels" msgstr "" #: ../../source/configuration/pluggable_panels.rst:172 msgid "The following keys are specific to registering or removing a panel:" msgstr "" #: ../../source/configuration/pluggable_panels.rst:175 msgid "``PANEL``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:179 msgid "The slug of the panel to be added to ``HORIZON_CONFIG``. Required." msgstr "" #: ../../source/configuration/pluggable_panels.rst:182 msgid "``PANEL_DASHBOARD``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:186 msgid "The slug of the dashboard the ``PANEL`` associated with. Required." msgstr "" #: ../../source/configuration/pluggable_panels.rst:190 #: ../../source/configuration/pluggable_panels.rst:258 msgid "``PANEL_GROUP``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:194 msgid "" "The slug of the panel group the ``PANEL`` is associated with. If you want " "the panel to show up without a panel group, use the panel group \"default\"." msgstr "" #: ../../source/configuration/pluggable_panels.rst:198 msgid "``DEFAULT_PANEL``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:202 msgid "If set, it will update the default panel of the ``PANEL_DASHBOARD``." msgstr "" #: ../../source/configuration/pluggable_panels.rst:205 msgid "``ADD_PANEL``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:209 msgid "Python panel class of the ``PANEL`` to be added." msgstr "" #: ../../source/configuration/pluggable_panels.rst:212 msgid "``REMOVE_PANEL``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:216 msgid "" "If set to ``True``, the PANEL will be removed from PANEL_DASHBOARD/" "PANEL_GROUP." msgstr "" #: ../../source/configuration/pluggable_panels.rst:222 msgid "" "To add a new panel to the Admin panel group in Admin dashboard, create a " "file ``openstack_dashboard/local/enabled/_60_admin_add_panel.py`` with the " "following content::" msgstr "" #: ../../source/configuration/pluggable_panels.rst:231 msgid "" "To remove Info panel from Admin panel group in Admin dashboard locally, " "create a file ``openstack_dashboard/local/enabled/_70_admin_remove_panel." "py`` with the following content::" msgstr "" #: ../../source/configuration/pluggable_panels.rst:240 msgid "" "To change the default panel of Admin dashboard to Instances panel, create a " "file ``openstack_dashboard/local/enabled/_80_admin_default_panel.py`` with " "the following content::" msgstr "" #: ../../source/configuration/pluggable_panels.rst:250 msgid "Pluggable Settings for Panel Groups" msgstr "" #: ../../source/configuration/pluggable_panels.rst:255 msgid "The following keys are specific to registering a panel group:" msgstr "" #: ../../source/configuration/pluggable_panels.rst:262 msgid "" "The slug of the panel group to be added to ``HORIZON_CONFIG``. Required." msgstr "" #: ../../source/configuration/pluggable_panels.rst:265 msgid "``PANEL_GROUP_NAME``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:269 msgid "The display name of the PANEL_GROUP. Required." msgstr "" #: ../../source/configuration/pluggable_panels.rst:272 msgid "``PANEL_GROUP_DASHBOARD``" msgstr "" #: ../../source/configuration/pluggable_panels.rst:276 msgid "" "The slug of the dashboard the ``PANEL_GROUP`` associated with. Required." msgstr "" #: ../../source/configuration/pluggable_panels.rst:283 msgid "" "To add a new panel group to the Admin dashboard, create a file " "``openstack_dashboard/local/enabled/_90_admin_add_panel_group.py`` with the " "following content::" msgstr "" #: ../../source/configuration/settings.rst:5 msgid "Settings Reference" msgstr "" #: ../../source/configuration/settings.rst:10 msgid "Horizon's settings broadly fall into three categories:" msgstr "" #: ../../source/configuration/settings.rst:12 msgid "" "`General Settings`_: this includes visual settings like the modal backdrop " "style, bug url and theme configuration, as well as settings that affect " "every service, such as page sizes on API requests." msgstr "" #: ../../source/configuration/settings.rst:15 msgid "" "`Service-specific Settings`_: Many services that Horizon consumes, such as " "Nova and Neutron, don't advertise their capabilities via APIs, so Horizon " "carries configuration for operators to enable or disable many items. This " "section covers all settings that are specific to a single service." msgstr "" #: ../../source/configuration/settings.rst:19 msgid "" "`Django Settings`_, which are common to all Django applications. The only " "ones documented here are those that Horizon alters by default; however, you " "should read the `Django settings documentation `_ to see the other options available to you." msgstr "" #: ../../source/configuration/settings.rst:25 msgid "To modify your settings, you have two options:" msgstr "" #: ../../source/configuration/settings.rst:27 msgid "" "**Preferred:** Add ``.py`` settings snippets to the ``openstack_dashboard/" "local/local_settings.d/`` directory. Several example files (appended with ``." "example``) can be found there. These must start with an underscore, and are " "evaluated alphabetically, after ``local_settings.py``." msgstr "" #: ../../source/configuration/settings.rst:32 msgid "" "Modify your ``openstack_dashboard/local/local_settings.py``. There is an " "file found at ``openstack_dashboard/local/local_settings.py.example``." msgstr "" #: ../../source/configuration/settings.rst:36 msgid "General Settings" msgstr "" #: ../../source/configuration/settings.rst:41 msgid "ANGULAR_FEATURES" msgstr "" #: ../../source/configuration/settings.rst:45 #: ../../source/configuration/settings.rst:96 #: ../../source/configuration/settings.rst:240 #: ../../source/configuration/settings.rst:282 #: ../../source/configuration/settings.rst:347 #: ../../source/configuration/settings.rst:388 #: ../../source/configuration/settings.rst:464 #: ../../source/configuration/settings.rst:553 #: ../../source/configuration/settings.rst:715 #: ../../source/configuration/settings.rst:786 #: ../../source/configuration/settings.rst:811 #: ../../source/configuration/settings.rst:842 #: ../../source/configuration/settings.rst:1010 #: ../../source/configuration/settings.rst:1093 #: ../../source/configuration/settings.rst:1166 #: ../../source/configuration/settings.rst:1197 #: ../../source/configuration/settings.rst:1325 #: ../../source/configuration/settings.rst:1370 #: ../../source/configuration/settings.rst:1563 #: ../../source/configuration/settings.rst:1645 #: ../../source/configuration/settings.rst:1679 #: ../../source/configuration/settings.rst:1925 #: ../../source/configuration/settings.rst:2020 #: ../../source/configuration/settings.rst:2162 msgid "Default:" msgstr "" #: ../../source/configuration/settings.rst:59 msgid "" "A dictionary of currently available AngularJS features. This allows simple " "toggling of legacy or rewritten features, such as new panels, workflows etc." msgstr "" #: ../../source/configuration/settings.rst:64 msgid "" "If you toggle ``domains_panel`` to ``True``, you also need to enable the " "setting of `OPENSTACK_KEYSTONE_DEFAULT_DOMAIN`_ and add " "`OPENSTACK_KEYSTONE_DEFAULT_DOMAIN`_ to `REST_API_REQUIRED_SETTINGS`_." msgstr "" #: ../../source/configuration/settings.rst:69 msgid "API_RESULT_LIMIT" msgstr "" #: ../../source/configuration/settings.rst:73 msgid "Default: ``1000``" msgstr "" #: ../../source/configuration/settings.rst:75 msgid "" "The maximum number of objects (e.g. Swift objects or Glance images) to " "display on a single page before providing a paging element (a \"more\" link) " "to paginate results." msgstr "" #: ../../source/configuration/settings.rst:80 msgid "API_RESULT_PAGE_SIZE" msgstr "" #: ../../source/configuration/settings.rst:84 msgid "Default: ``20``" msgstr "" #: ../../source/configuration/settings.rst:86 msgid "" "Similar to ``API_RESULT_LIMIT``. This setting controls the number of items " "to be shown per page if API pagination support for this exists." msgstr "" #: ../../source/configuration/settings.rst:92 msgid "AVAILABLE_THEMES" msgstr "" #: ../../source/configuration/settings.rst:105 msgid "This setting tells Horizon which themes to use." msgstr "" #: ../../source/configuration/settings.rst:107 msgid "" "A list of tuples which define multiple themes. The tuple format is ``('{{ " "theme_name }}', '{{ theme_label }}', '{{ theme_path }}')``." msgstr "" #: ../../source/configuration/settings.rst:110 msgid "" "The ``theme_name`` is the name used to define the directory which the theme " "is collected into, under ``/{{ THEME_COLLECTION_DIR }}``. It also specifies " "the key by which the selected theme is stored in the browser's cookie." msgstr "" #: ../../source/configuration/settings.rst:115 msgid "" "The ``theme_label`` is the user-facing label that is shown in the theme " "picker. The theme picker is only visible if more than one theme is " "configured, and shows under the topnav's user menu." msgstr "" #: ../../source/configuration/settings.rst:119 msgid "" "By default, the ``theme path`` is the directory that will serve as the " "static root of the theme and the entire contents of the directory is served " "up at ``/{{ THEME_COLLECTION_DIR }}/{{ theme_name }}``. If you wish to " "include content other than static files in a theme directory, but do not " "wish that content to be served up, then you can create a sub directory named " "``static``. If the theme folder contains a sub-directory with the name " "``static``, then ``static/custom/static`` will be used as the root for the " "content served at ``/static/custom``." msgstr "" #: ../../source/configuration/settings.rst:129 #: ../../source/configuration/settings.rst:161 msgid "" "The static root of the theme folder must always contain a _variables.scss " "file and a _styles.scss file. These must contain or import all the " "bootstrap and horizon specific variables and styles which are used to style " "the GUI. For example themes, see: /horizon/openstack_dashboard/themes/" msgstr "" #: ../../source/configuration/settings.rst:134 msgid "" "Horizon ships with two themes configured. 'default' is the default theme, " "and 'material' is based on Google's Material Design." msgstr "" #: ../../source/configuration/settings.rst:140 msgid "CUSTOM_THEME_PATH" msgstr "" #: ../../source/configuration/settings.rst:146 #: ../../source/configuration/settings.rst:192 msgid "Themes are now controlled by `AVAILABLE_THEMES`_." msgstr "" #: ../../source/configuration/settings.rst:148 #: ../../source/configuration/settings.rst:194 msgid "Default: ``\"themes/default\"``" msgstr "" #: ../../source/configuration/settings.rst:150 msgid "This setting tells Horizon to use a directory as a custom theme." msgstr "" #: ../../source/configuration/settings.rst:152 msgid "" "By default, this directory will serve as the static root of the theme and " "the entire contents of the directory will be served up at ``/static/custom``." " If you wish to include content other than static files in a theme " "directory, but do not wish that content to be served up, then you can create " "a sub directory named ``static``. If the theme folder contains a sub-" "directory with the name ``static``, then ``static/custom/static`` will be " "used as the root for the content served at ``/static/custom``." msgstr "" #: ../../source/configuration/settings.rst:166 msgid "" "Horizon ships with one alternate theme based on Google's Material Design. " "To use the alternate theme, set your CUSTOM_THEME_PATH to ``themes/" "material``." msgstr "" #: ../../source/configuration/settings.rst:170 msgid "DEFAULT_THEME" msgstr "" #: ../../source/configuration/settings.rst:174 msgid "Default: ``\"default\"``" msgstr "" #: ../../source/configuration/settings.rst:176 msgid "" "This setting tells Horizon which theme to use if the user has not yet " "selected a theme through the theme picker and therefore set the cookie value." " This value represents the ``theme_name`` key that is used from " "`AVAILABLE_THEMES`_. To use this setting, the theme must also be configured " "inside of ``AVAILABLE_THEMES``. Your default theme must be configured as " "part of `SELECTABLE_THEMES`_. If it is not, then your ``DEFAULT_THEME`` " "will default to the first theme in ``SELECTABLE_THEMES``." msgstr "" #: ../../source/configuration/settings.rst:186 msgid "DEFAULT_THEME_PATH" msgstr "" #: ../../source/configuration/settings.rst:196 msgid "" "This setting allows Horizon to collect an additional theme during static " "collection and be served up via /static/themes/default. This is useful if " "CUSTOM_THEME_PATH inherits from another theme (like 'default')." msgstr "" #: ../../source/configuration/settings.rst:200 msgid "" "If DEFAULT_THEME_PATH is the same as CUSTOM_THEME_PATH, then collection is " "skipped and /static/themes will not exist." msgstr "" #: ../../source/configuration/settings.rst:204 msgid "DISALLOW_IFRAME_EMBED" msgstr "" #: ../../source/configuration/settings.rst:208 #: ../../source/configuration/settings.rst:486 #: ../../source/configuration/settings.rst:886 #: ../../source/configuration/settings.rst:1034 #: ../../source/configuration/settings.rst:1266 #: ../../source/configuration/settings.rst:1454 #: ../../source/configuration/settings.rst:1733 #: ../../source/configuration/settings.rst:1783 #: ../../source/configuration/settings.rst:2052 #: ../../source/configuration/settings.rst:2102 #: ../../source/configuration/settings.rst:2134 #: ../../source/configuration/settings.rst:2196 #: ../../source/configuration/settings.rst:2370 msgid "Default: ``True``" msgstr "" #: ../../source/configuration/settings.rst:210 msgid "" "This setting can be used to defend against Clickjacking and prevent Horizon " "from being embedded within an iframe. Legacy browsers are still vulnerable " "to a Cross-Frame Scripting (XFS) vulnerability, so this option allows extra " "security hardening where iframes are not used in deployment. When set to " "true, a ``\"frame-buster\"`` script is inserted into the template header " "that prevents the web page from being framed and therefore defends against " "clickjacking." msgstr "" #: ../../source/configuration/settings.rst:217 msgid "For more information see: http://tinyurl.com/anticlickjack" msgstr "" #: ../../source/configuration/settings.rst:221 msgid "" "If your deployment requires the use of iframes, you can set this setting to " "``False`` to exclude the frame-busting code and allow iframe embedding." msgstr "" #: ../../source/configuration/settings.rst:225 msgid "DROPDOWN_MAX_ITEMS" msgstr "" #: ../../source/configuration/settings.rst:229 msgid "Default: ``30``" msgstr "" #: ../../source/configuration/settings.rst:231 msgid "" "This setting sets the maximum number of items displayed in a dropdown. " "Dropdowns that limit based on this value need to support a way to observe " "the entire list." msgstr "" #: ../../source/configuration/settings.rst:236 msgid "FILTER_DATA_FIRST" msgstr "" #: ../../source/configuration/settings.rst:252 msgid "" "If the dict key-value is True, when the view loads, an empty table will be " "rendered and the user will be asked to provide a search criteria first (in " "case no search criteria was provided) before loading any data." msgstr "" #: ../../source/configuration/settings.rst:256 msgid "Examples:" msgstr "" #: ../../source/configuration/settings.rst:258 msgid "Override the dict:" msgstr "" #: ../../source/configuration/settings.rst:270 msgid "Or, if you want to turn this on for an specific panel/view do:" msgstr "" #: ../../source/configuration/settings.rst:277 msgid "HORIZON_CONFIG" msgstr "" #: ../../source/configuration/settings.rst:279 msgid "" "A dictionary of some Horizon configuration values. These are primarily " "separated for historic design reasons." msgstr "" #: ../../source/configuration/settings.rst:312 msgid "ajax_poll_interval" msgstr "" #: ../../source/configuration/settings.rst:316 msgid "Default: ``2500``" msgstr "" #: ../../source/configuration/settings.rst:318 msgid "" "How frequently resources in transition states should be polled for updates, " "expressed in milliseconds." msgstr "" #: ../../source/configuration/settings.rst:322 msgid "ajax_queue_limit" msgstr "" #: ../../source/configuration/settings.rst:326 msgid "Default: ``10``" msgstr "" #: ../../source/configuration/settings.rst:328 msgid "" "The maximum number of simultaneous AJAX connections the dashboard may try to " "make. This is particularly relevant when monitoring a large number of " "instances, volumes, etc. which are all actively trying to update/change " "state." msgstr "" #: ../../source/configuration/settings.rst:333 msgid "angular_modules" msgstr "" #: ../../source/configuration/settings.rst:337 #: ../../source/configuration/settings.rst:417 #: ../../source/configuration/settings.rst:429 #: ../../source/configuration/settings.rst:1114 #: ../../source/configuration/settings.rst:1834 #: ../../source/configuration/settings.rst:2229 #: ../../source/configuration/settings.rst:2291 #: ../../source/configuration/settings.rst:2304 msgid "Default: ``[]``" msgstr "" #: ../../source/configuration/settings.rst:343 msgid "auto_fade_alerts" msgstr "" #: ../../source/configuration/settings.rst:357 msgid "" "If provided, will auto-fade the alert types specified. Valid alert types " "include: ['alert-default', 'alert-success', 'alert-info', 'alert-warning', " "'alert-danger'] Can also define the delay before the alert fades and the " "fade out duration." msgstr "" #: ../../source/configuration/settings.rst:363 msgid "bug_url" msgstr "" #: ../../source/configuration/settings.rst:367 #: ../../source/configuration/settings.rst:407 #: ../../source/configuration/settings.rst:522 #: ../../source/configuration/settings.rst:597 #: ../../source/configuration/settings.rst:671 #: ../../source/configuration/settings.rst:1143 #: ../../source/configuration/settings.rst:1225 msgid "Default: ``None``" msgstr "" #: ../../source/configuration/settings.rst:369 msgid "" "If provided, a \"Report Bug\" link will be displayed in the site header " "which links to the value of this setting (ideally a URL containing " "information on how to report issues)." msgstr "" #: ../../source/configuration/settings.rst:374 msgid "disable_password_reveal" msgstr "" #: ../../source/configuration/settings.rst:378 #: ../../source/configuration/settings.rst:685 #: ../../source/configuration/settings.rst:695 #: ../../source/configuration/settings.rst:1128 #: ../../source/configuration/settings.rst:1276 #: ../../source/configuration/settings.rst:1387 #: ../../source/configuration/settings.rst:1400 #: ../../source/configuration/settings.rst:1412 #: ../../source/configuration/settings.rst:1501 #: ../../source/configuration/settings.rst:1518 #: ../../source/configuration/settings.rst:1586 #: ../../source/configuration/settings.rst:1719 #: ../../source/configuration/settings.rst:1750 #: ../../source/configuration/settings.rst:1764 #: ../../source/configuration/settings.rst:1772 #: ../../source/configuration/settings.rst:1979 #: ../../source/configuration/settings.rst:2043 #: ../../source/configuration/settings.rst:2062 #: ../../source/configuration/settings.rst:2072 #: ../../source/configuration/settings.rst:2082 #: ../../source/configuration/settings.rst:2092 #: ../../source/configuration/settings.rst:2116 msgid "Default: ``False``" msgstr "" #: ../../source/configuration/settings.rst:380 msgid "" "Setting this to True will disable the reveal button for password fields, " "including on the login form." msgstr "" #: ../../source/configuration/settings.rst:384 msgid "exceptions" msgstr "" #: ../../source/configuration/settings.rst:398 msgid "" "A dictionary containing classes of exceptions which Horizon's centralized " "exception handling should be aware of. Based on these exception categories, " "Horizon will handle the exception and display a message to the user." msgstr "" #: ../../source/configuration/settings.rst:403 msgid "help_url" msgstr "" #: ../../source/configuration/settings.rst:409 msgid "" "If provided, a \"Help\" link will be displayed in the site header which " "links to the value of this setting (ideally a URL containing help " "information)." msgstr "" #: ../../source/configuration/settings.rst:413 msgid "js_files" msgstr "" #: ../../source/configuration/settings.rst:419 msgid "" "A list of javascript source files to be included in the compressed set of " "files that are loaded on every page. This is needed for AngularJS modules " "that are referenced in ``angular_modules`` and therefore need to be include " "in every page." msgstr "" #: ../../source/configuration/settings.rst:425 msgid "js_spec_files" msgstr "" #: ../../source/configuration/settings.rst:436 msgid "modal_backdrop" msgstr "" #: ../../source/configuration/settings.rst:440 msgid "Default: ``\"static\"``" msgstr "" #: ../../source/configuration/settings.rst:442 msgid "" "Controls how bootstrap backdrop element outside of modals looks and feels. " "Valid values are ``\"true\"`` (show backdrop element outside the modal, " "close the modal after clicking on backdrop), ``\"false\"`` (do not show " "backdrop element, do not close the modal after clicking outside of it) and " "``\"static\"`` (show backdrop element outside the modal, do not close the " "modal after clicking on backdrop)." msgstr "" #: ../../source/configuration/settings.rst:450 msgid "password_autocomplete" msgstr "" #: ../../source/configuration/settings.rst:454 msgid "Default: ``\"off\"``" msgstr "" #: ../../source/configuration/settings.rst:456 msgid "" "Controls whether browser autocompletion should be enabled on the login form. " "Valid values are ``\"on\"`` and ``\"off\"``." msgstr "" #: ../../source/configuration/settings.rst:460 msgid "password_validator" msgstr "" #: ../../source/configuration/settings.rst:473 msgid "" "A dictionary containing a regular expression which will be used for password " "validation and help text which will be displayed if the password does not " "pass validation. The help text should describe the password requirements if " "there are any." msgstr "" #: ../../source/configuration/settings.rst:478 msgid "" "This setting allows you to set rules for passwords if your organization " "requires them." msgstr "" #: ../../source/configuration/settings.rst:482 msgid "simple_ip_management" msgstr "" #: ../../source/configuration/settings.rst:488 msgid "Enable or disable simplified floating IP address management." msgstr "" #: ../../source/configuration/settings.rst:490 msgid "" "\"Simple\" floating IP address management means that the user does not ever " "have to select the specific IP addresses they wish to use, and the process " "of allocating an IP and assigning it to an instance is one-click." msgstr "" #: ../../source/configuration/settings.rst:494 msgid "" "The \"advanced\" floating IP management allows users to select the floating " "IP pool from which the IP should be allocated and to select a specific IP " "address when associating one with an instance." msgstr "" #: ../../source/configuration/settings.rst:500 msgid "" "Currently \"simple\" floating IP address management is not compatible with " "Neutron. There are two reasons for this. First, Neutron does not support the " "default floating IP pool at the moment. Second, a Neutron floating IP can be " "associated with each VIF and we need to check whether there is only one VIF " "for an instance to enable simple association support." msgstr "" #: ../../source/configuration/settings.rst:507 msgid "user_home" msgstr "" #: ../../source/configuration/settings.rst:511 msgid "Default: ``settings.LOGIN_REDIRECT_URL``" msgstr "" #: ../../source/configuration/settings.rst:513 msgid "" "This can be either a literal URL path (such as the default), or Python's " "dotted string notation representing a function which will evaluate what URL " "a user should be redirected to based on the attributes of that user." msgstr "" #: ../../source/configuration/settings.rst:518 msgid "MESSAGES_PATH" msgstr "" #: ../../source/configuration/settings.rst:524 msgid "The absolute path to the directory where message files are collected." msgstr "" #: ../../source/configuration/settings.rst:526 msgid "" "When the user logins to horizon, the message files collected are processed " "and displayed to the user. Each message file should contain a JSON formatted " "data and must have a .json file extension. For example:" msgstr "" #: ../../source/configuration/settings.rst:537 msgid "" "Possible values for level are: ``success``, ``info``, ``warning`` and " "``error``." msgstr "" #: ../../source/configuration/settings.rst:541 msgid "NG_TEMPLATE_CACHE_AGE" msgstr "" #: ../../source/configuration/settings.rst:545 msgid "" "Angular Templates are cached using this duration (in seconds) if `DEBUG`_ is " "set to ``False``. Default value is ``2592000`` (or 30 days)." msgstr "" #: ../../source/configuration/settings.rst:549 msgid "OPENSTACK_API_VERSIONS" msgstr "" #: ../../source/configuration/settings.rst:564 msgid "" "Overrides for OpenStack API versions. Use this setting to force the " "OpenStack dashboard to use a specific API version for a given service API." msgstr "" #: ../../source/configuration/settings.rst:569 msgid "" "The version should be formatted as it appears in the URL for the service API." " For example, the identity service APIs have inconsistent use of the decimal " "point, so valid options would be \"2.0\" or \"3\". For example:" msgstr "" #: ../../source/configuration/settings.rst:584 msgid "OPENSTACK_CLOUDS_YAML_NAME" msgstr "" #: ../../source/configuration/settings.rst:588 msgid "Default: ``\"openstack\"``" msgstr "" #: ../../source/configuration/settings.rst:590 msgid "The name of the entry to put into the user's clouds.yaml file." msgstr "" #: ../../source/configuration/settings.rst:593 msgid "OPENSTACK_CLOUDS_YAML_PROFILE" msgstr "" #: ../../source/configuration/settings.rst:599 msgid "If set, the name of the `vendor profile`_ from `os-client-config`_." msgstr "" #: ../../source/configuration/settings.rst:605 msgid "OPENSTACK_ENDPOINT_TYPE" msgstr "" #: ../../source/configuration/settings.rst:609 msgid "Default: ``\"publicURL\"``" msgstr "" #: ../../source/configuration/settings.rst:611 msgid "" "A string which specifies the endpoint type to use for the endpoints in the " "Keystone service catalog. The default value for all services except for " "identity is ``\"publicURL\"`` . The default value for the identity service " "is ``\"internalURL\"``." msgstr "" #: ../../source/configuration/settings.rst:617 msgid "OPENSTACK_HOST" msgstr "" #: ../../source/configuration/settings.rst:621 msgid "Default: ``\"127.0.0.1\"``" msgstr "" #: ../../source/configuration/settings.rst:623 msgid "" "The hostname of the Keystone server used for authentication if you only have " "one region. This is often the **only** setting that needs to be set for a " "basic deployment." msgstr "" #: ../../source/configuration/settings.rst:627 msgid "" "If you have multiple regions you should use the `AVAILABLE_REGIONS`_ setting " "instead." msgstr "" #: ../../source/configuration/settings.rst:631 msgid "OPENSTACK_PROFILER" msgstr "" #: ../../source/configuration/settings.rst:635 msgid "Default: ``{\"enabled\": False}``" msgstr "" #: ../../source/configuration/settings.rst:637 msgid "" "Various settings related to integration with osprofiler library. Since it is " "a developer feature, it starts as disabled. To enable it, more than a single " "``\"enabled\"`` key should be specified. Additional keys that should be " "specified in that dictionary are:" msgstr "" #: ../../source/configuration/settings.rst:642 msgid "" "``\"keys\"`` is a list of strings, which are secret keys used to encode/" "decode the profiler data contained in request headers. Encryption is used " "for security purposes, other OpenStack components that are expected to " "profile themselves with osprofiler using the data from the request that " "Horizon initiated must share a common set of keys with the ones in Horizon " "config. List of keys is used so that security keys could be changed in non-" "obtrusive manner for every component in the cloud. Example: ``\"keys\": " "[\"SECRET_KEY\", \"MORE_SECRET_KEY\"]``. For more details see `osprofiler " "documentation`_." msgstr "" #: ../../source/configuration/settings.rst:651 msgid "" "``\"notifier_connection_string\"`` is a url to which trace messages are sent " "by Horizon. For other components it is usually the only URL specified in " "config, because other components act mostly as traces producers. Example: " "``\"notifier_connection_string\": \"mongodb://%s' % OPENSTACK_HOST\"``." msgstr "" #: ../../source/configuration/settings.rst:655 msgid "" "``\"receiver_connection_string\"`` is a url from which traces are retrieved " "by Horizon, needed because Horizon is not only the traces producer, but also " "a consumer. Having 2 settings which usually contain the same value is legacy " "feature from older versions of osprofiler when OpenStack components could " "use oslo.messaging for notifications and the trace client used ceilometer as " "a receiver backend. By default Horizon uses the same URL pointing to a " "MongoDB cluster for both purposes, since ceilometer was too slow for using " "with UI. Example: ``\"receiver_connection_string\": \"mongodb://%s\" % " "OPENSTACK_HOST``." msgstr "" #: ../../source/configuration/settings.rst:667 msgid "OPENSTACK_SSL_CACERT" msgstr "" #: ../../source/configuration/settings.rst:673 msgid "" "When unset or set to ``None`` the default CA certificate on the system is " "used for SSL verification." msgstr "" #: ../../source/configuration/settings.rst:676 msgid "" "When set with the path to a custom CA certificate file, this overrides use " "of the default system CA certificate. This custom certificate is used to " "verify all connections to openstack services when making API calls." msgstr "" #: ../../source/configuration/settings.rst:681 msgid "OPENSTACK_SSL_NO_VERIFY" msgstr "" #: ../../source/configuration/settings.rst:687 msgid "" "Disable SSL certificate checks in the OpenStack clients (useful for self-" "signed certificates)." msgstr "" #: ../../source/configuration/settings.rst:691 msgid "OPERATION_LOG_ENABLED" msgstr "" #: ../../source/configuration/settings.rst:697 msgid "" "This setting can be used to enable logging of all operations carried out by " "users of Horizon. The format of the logs is configured via " "`OPERATION_LOG_OPTIONS`_" msgstr "" #: ../../source/configuration/settings.rst:703 msgid "" "If you use this feature, you need to configure the logger setting like a " "outputting path for operation log in ``local_settings.py``." msgstr "" #: ../../source/configuration/settings.rst:707 msgid "OPERATION_LOG_OPTIONS" msgstr "" #: ../../source/configuration/settings.rst:713 msgid "" "Added ``ignored_urls`` parameter and added ``%(client_ip)s`` to ``format``" msgstr "" #: ../../source/configuration/settings.rst:729 msgid "This setting controls the behavior of the operation log." msgstr "" #: ../../source/configuration/settings.rst:731 msgid "" "``mask_fields`` is a list of keys of post data which should be masked from " "the point of view of security. Fields like ``password`` should be included. " "The fields specified in ``mask_fields`` are logged as ``********``." msgstr "" #: ../../source/configuration/settings.rst:734 msgid "" "``target_methods`` is a request method which is logged to a operation log. " "The valid methods are ``POST``, ``GET``, ``PUT``, ``DELETE``." msgstr "" #: ../../source/configuration/settings.rst:736 msgid "``ignored_urls`` is a list of request URLs to be hidden from a log." msgstr "" #: ../../source/configuration/settings.rst:737 msgid "" "``format`` defines the operation log format. Currently you can use the " "following keywords. The default value contains all keywords." msgstr "" #: ../../source/configuration/settings.rst:741 msgid "``%(client_ip)s``" msgstr "" #: ../../source/configuration/settings.rst:742 msgid "``%(domain_name)s``" msgstr "" #: ../../source/configuration/settings.rst:743 msgid "``%(domain_id)s``" msgstr "" #: ../../source/configuration/settings.rst:744 msgid "``%(project_name)s``" msgstr "" #: ../../source/configuration/settings.rst:745 msgid "``%(project_id)s``" msgstr "" #: ../../source/configuration/settings.rst:746 msgid "``%(user_name)s``" msgstr "" #: ../../source/configuration/settings.rst:747 msgid "``%(user_id)s``" msgstr "" #: ../../source/configuration/settings.rst:748 msgid "``%(request_scheme)s``" msgstr "" #: ../../source/configuration/settings.rst:749 msgid "``%(referer_url)s``" msgstr "" #: ../../source/configuration/settings.rst:750 msgid "``%(request_url)s``" msgstr "" #: ../../source/configuration/settings.rst:751 msgid "``%(message)s``" msgstr "" #: ../../source/configuration/settings.rst:752 msgid "``%(method)s``" msgstr "" #: ../../source/configuration/settings.rst:753 msgid "``%(http_status)s``" msgstr "" #: ../../source/configuration/settings.rst:754 msgid "``%(param)s``" msgstr "" #: ../../source/configuration/settings.rst:757 msgid "OVERVIEW_DAYS_RANGE" msgstr "" #: ../../source/configuration/settings.rst:761 msgid "Default:: ``1``" msgstr "" #: ../../source/configuration/settings.rst:763 msgid "" "When set to an integer N (as by default), the start date in the Overview " "panel meters will be today minus N days. This setting is used to limit the " "amount of data fetched by default when rendering the Overview panel. If set " "to ``None`` (which corresponds to the behavior in past Horizon versions), " "the start date will be from the beginning of the current month until the " "current date. The legacy behaviour is not recommended for large deployments " "as Horizon suffers significant lag in this case." msgstr "" #: ../../source/configuration/settings.rst:772 msgid "POLICY_CHECK_FUNCTION" msgstr "" #: ../../source/configuration/settings.rst:776 msgid "Default:: ``openstack_auth.policy.check``" msgstr "" #: ../../source/configuration/settings.rst:778 msgid "" "This value should not be changed, although removing it or setting it to " "``None`` would be a means to bypass all policy checks." msgstr "" #: ../../source/configuration/settings.rst:782 msgid "POLICY_DIRS" msgstr "" #: ../../source/configuration/settings.rst:795 msgid "" "Specifies a list of policy directories per service types. The directories " "are relative to `POLICY_FILES_PATH`_. Services whose additional policies are " "defined here must be defined in `POLICY_FILES`_ too. Otherwise, additional " "policies specified in ``POLICY_DIRS`` are not loaded." msgstr "" #: ../../source/configuration/settings.rst:802 msgid "" "``cinder_policy.d`` and ``nova_policy.d`` are registered by default to " "maintain policies which have ben dropped from nova and cinder but horizon " "still uses. We recommend not to drop them." msgstr "" #: ../../source/configuration/settings.rst:807 msgid "POLICY_FILES" msgstr "" #: ../../source/configuration/settings.rst:823 msgid "" "This should essentially be the mapping of the contents of " "`POLICY_FILES_PATH`_ to service types. When policy.json files are added to " "`POLICY_FILES_PATH`_, they should be included here too." msgstr "" #: ../../source/configuration/settings.rst:828 msgid "POLICY_FILES_PATH" msgstr "" #: ../../source/configuration/settings.rst:832 msgid "Default: ``os.path.join(ROOT_PATH, \"conf\")``" msgstr "" #: ../../source/configuration/settings.rst:834 msgid "" "Specifies where service based policy files are located. These are used to " "define the policy rules actions are verified against." msgstr "" #: ../../source/configuration/settings.rst:838 msgid "REST_API_REQUIRED_SETTINGS" msgstr "" #: ../../source/configuration/settings.rst:853 msgid "" "This setting allows you to expose configuration values over Horizons " "internal REST API, so that the AngularJS panels can access them. Please be " "cautious about which values are listed here (and thus exposed on the " "frontend)" msgstr "" #: ../../source/configuration/settings.rst:858 msgid "SELECTABLE_THEMES" msgstr "" #: ../../source/configuration/settings.rst:862 msgid "Default: ``AVAILABLE_THEMES``" msgstr "" #: ../../source/configuration/settings.rst:864 msgid "" "This setting tells Horizon which themes to expose to the user as selectable " "in the theme picker widget. This value defaults to all themes configured in " "`AVAILABLE_THEMES`_, but a brander may wish to simply inherit from an " "existing theme and not allow that parent theme to be selected by the user. " "``SELECTABLE_THEMES`` takes the exact same format as ``AVAILABLE_THEMES``." msgstr "" #: ../../source/configuration/settings.rst:871 msgid "SESSION_TIMEOUT" msgstr "" #: ../../source/configuration/settings.rst:875 msgid "Default: ``\"3600\"``" msgstr "" #: ../../source/configuration/settings.rst:877 msgid "" "This SESSION_TIMEOUT is a method to supercede the token timeout with a " "shorter horizon session timeout (in seconds). So if your token expires in " "60 minutes, a value of 1800 will log users out after 30 minutes." msgstr "" #: ../../source/configuration/settings.rst:882 msgid "SHOW_KEYSTONE_V2_RC" msgstr "" #: ../../source/configuration/settings.rst:888 msgid "" "Controls whether the keystone v2 openrc file is accessable from the user " "menu and the api access panel." msgstr "" #: ../../source/configuration/settings.rst:892 msgid "THEME_COLLECTION_DIR" msgstr "" #: ../../source/configuration/settings.rst:896 msgid "Default: ``\"themes\"``" msgstr "" #: ../../source/configuration/settings.rst:898 msgid "" "This setting tells Horizon which static directory to collect the available " "themes into, and therefore which URL points to the theme collection root. " "For example, the default theme would be accessible via ``/{{ STATIC_URL }}/" "themes/default``." msgstr "" #: ../../source/configuration/settings.rst:904 msgid "THEME_COOKIE_NAME" msgstr "" #: ../../source/configuration/settings.rst:908 msgid "Default: ``\"theme\"``" msgstr "" #: ../../source/configuration/settings.rst:910 msgid "" "This setting tells Horizon in which cookie key to store the currently set " "theme. The cookie expiration is currently set to a year." msgstr "" #: ../../source/configuration/settings.rst:914 msgid "USER_MENU_LINKS" msgstr "" #: ../../source/configuration/settings.rst:918 msgid "Default::" msgstr "" #: ../../source/configuration/settings.rst:933 msgid "" "This setting controls the additional links on the user drop down menu. A " "list of dictionaries defining all of the links should be provided. This " "defaults to the standard OpenStack RC files." msgstr "" #: ../../source/configuration/settings.rst:937 msgid "Each dictionary should contain these values:" msgstr "" #: ../../source/configuration/settings.rst:940 msgid "The name of the link" msgstr "" #: ../../source/configuration/settings.rst:940 msgid "name" msgstr "" #: ../../source/configuration/settings.rst:943 msgid "Either the reversible Django url name or an absolute url" msgstr "" #: ../../source/configuration/settings.rst:943 msgid "url" msgstr "" #: ../../source/configuration/settings.rst:946 msgid "True for absolute URLs, False for django urls." msgstr "" #: ../../source/configuration/settings.rst:946 msgid "external" msgstr "" #: ../../source/configuration/settings.rst:949 msgid "" "A list of classes for the icon next to the link. If 'None' or an empty list " "is provided a download icon will show" msgstr "" #: ../../source/configuration/settings.rst:950 msgid "icon_classes" msgstr "" #: ../../source/configuration/settings.rst:953 msgid "WEBROOT" msgstr "" #: ../../source/configuration/settings.rst:957 msgid "Default: ``\"/\"``" msgstr "" #: ../../source/configuration/settings.rst:959 msgid "" "Specifies the location where the access to the dashboard is configured in " "the web server." msgstr "" #: ../../source/configuration/settings.rst:962 msgid "" "For example, if you're accessing the Dashboard via ``https:///" "dashboard``, you would set this to ``\"/dashboard/\"``." msgstr "" #: ../../source/configuration/settings.rst:967 msgid "" "Additional settings may be required in the config files of your webserver of " "choice. For example to make ``\"/dashboard/\"`` the web root in Apache, the " "``\"sites-available/horizon.conf\"`` requires a couple of additional aliases " "set::" msgstr "" #: ../../source/configuration/settings.rst:976 msgid "" "Apache also requires changing your WSGIScriptAlias to reflect the desired " "path. For example, you'd replace ``/`` with ``/dashboard`` for the alias." msgstr "" #: ../../source/configuration/settings.rst:983 msgid "Service-specific Settings" msgstr "" #: ../../source/configuration/settings.rst:985 msgid "" "The following settings inform the OpenStack Dashboard of information about " "the other OpenStack projects which are part of this cloud and control the " "behavior of specific dashboards, panels, API calls, etc." msgstr "" #: ../../source/configuration/settings.rst:990 msgid "Cinder" msgstr "" #: ../../source/configuration/settings.rst:993 msgid "OPENSTACK_CINDER_FEATURES" msgstr "" #: ../../source/configuration/settings.rst:997 msgid "Default: ``{'enable_backup': False}``" msgstr "" #: ../../source/configuration/settings.rst:999 msgid "" "A dictionary of settings which can be used to enable optional services " "provided by cinder. Currently only the backup service is available." msgstr "" #: ../../source/configuration/settings.rst:1003 msgid "Glance" msgstr "" #: ../../source/configuration/settings.rst:1006 msgid "CREATE_IMAGE_DEFAULTS" msgstr "" #: ../../source/configuration/settings.rst:1018 msgid "A dictionary of default settings for create image modal." msgstr "" #: ../../source/configuration/settings.rst:1020 msgid "" "The ``image_visibility`` setting specifies the default visibility option. " "Valid values are ``\"public\"`` and ``\"private\"``. By default, the " "visibility option is public on create image modal. If it's set to " "``\"private\"``, the default visibility option is private." msgstr "" #: ../../source/configuration/settings.rst:1026 msgid "HORIZON_IMAGES_ALLOW_UPLOAD" msgstr "" #: ../../source/configuration/settings.rst:1032 msgid "Use `HORIZON_IMAGES_UPLOAD_MODE`_ instead." msgstr "" #: ../../source/configuration/settings.rst:1036 msgid "" "If set to ``False``, this setting disables **local** uploads to prevent " "filling up the disk on the dashboard server since uploads to the Glance " "image store service tend to be particularly large - in the order of hundreds " "of megabytes to multiple gigabytes." msgstr "" #: ../../source/configuration/settings.rst:1041 msgid "" "The setting is marked as deprecated and will be removed in P or later " "release. It is superseded by the setting HORIZON_IMAGES_UPLOAD_MODE. Until " "the removal the ``False`` value of HORIZON_IMAGES_ALLOW_UPLOAD overrides the " "value of HORIZON_IMAGES_UPLOAD_MODE." msgstr "" #: ../../source/configuration/settings.rst:1048 msgid "" "This will not disable image creation altogether, as this setting does not " "affect images created by specifying an image location (URL) as the image " "source." msgstr "" #: ../../source/configuration/settings.rst:1053 msgid "HORIZON_IMAGES_UPLOAD_MODE" msgstr "" #: ../../source/configuration/settings.rst:1057 msgid "Default: ``\"legacy\"``" msgstr "" #: ../../source/configuration/settings.rst:1059 msgid "" "Valid values are ``\"direct\"``, ``\"legacy\"`` (default) and ``\"off\"``. " "``\"off\"`` disables the ability to upload images via Horizon. It is " "equivalent to setting ``False`` on the deprecated setting " "``HORIZON_IMAGES_ALLOW_UPLOAD``. ``legacy`` enables local file upload by " "piping the image file through the Horizon's web-server. It is equivalent to " "setting ``True`` on the deprecated setting ``HORIZON_IMAGES_ALLOW_UPLOAD``. " "``direct`` sends the image file directly from the web browser to Glance. " "This bypasses Horizon web-server which both reduces network hops and " "prevents filling up Horizon web-server's filesystem. ``direct`` is the " "preferred mode, but due to the following requirements it is not the default. " "The ``direct`` setting requires a modern web browser, network access from " "the browser to the public Glance endpoint, and CORS support to be enabled on " "the Glance API service. Without CORS support, the browser will forbid the " "PUT request to a location different than the Horizon server. To enable CORS " "support for Glance API service, you will need to edit [cors] section of " "glance-api.conf file (see `here`_ how to do it). Set `allowed_origin` to the " "full hostname of Horizon web-server (e.g. http:///dashboard) and " "restart glance-api process." msgstr "" #: ../../source/configuration/settings.rst:1081 msgid "" "To maintain the compatibility with the deprecated " "HORIZON_IMAGES_ALLOW_UPLOAD setting, neither ``\"direct\"``, nor " "``\"legacy\"`` modes will have an effect if HORIZON_IMAGES_ALLOW_UPLOAD is " "set to ``False`` - as if HORIZON_IMAGES_UPLOAD_MODE was set to ``\"off\"`` " "itself. When HORIZON_IMAGES_ALLOW_UPLOAD is set to ``True``, all three modes " "are considered, as if HORIZON_IMAGES_ALLOW_UPLOAD setting was removed." msgstr "" #: ../../source/configuration/settings.rst:1089 msgid "IMAGE_CUSTOM_PROPERTY_TITLES" msgstr "" #: ../../source/configuration/settings.rst:1106 msgid "" "Used to customize the titles for image custom property attributes that " "appear on image detail pages." msgstr "" #: ../../source/configuration/settings.rst:1110 msgid "IMAGE_RESERVED_CUSTOM_PROPERTIES" msgstr "" #: ../../source/configuration/settings.rst:1116 msgid "" "A list of image custom property keys that should not be displayed in the " "Update Metadata tree." msgstr "" #: ../../source/configuration/settings.rst:1119 msgid "" "This setting can be used in the case where a separate panel is used for " "managing a custom property or if a certain custom property should never be " "edited." msgstr "" #: ../../source/configuration/settings.rst:1124 msgid "IMAGES_ALLOW_LOCATION" msgstr "" #: ../../source/configuration/settings.rst:1130 msgid "" "If set to ``True``, this setting allows users to specify an image location " "(URL) as the image source when creating or updating images. Depending on the " "Glance version, the ability to set an image location is controlled by " "policies and/or the Glance configuration. Therefore IMAGES_ALLOW_LOCATION " "should only be set to ``True`` if Glance is configured to allow specifying a " "location. This setting has no effect when the Keystone catalog doesn't " "contain a Glance v2 endpoint." msgstr "" #: ../../source/configuration/settings.rst:1139 msgid "IMAGES_LIST_FILTER_TENANTS" msgstr "" #: ../../source/configuration/settings.rst:1145 msgid "" "A list of dictionaries to add optional categories to the image fixed filters " "in the Images panel, based on project ownership." msgstr "" #: ../../source/configuration/settings.rst:1148 msgid "" "Each dictionary should contain a `tenant` attribute with the project id, and " "optionally a `text` attribute specifying the category name, and an `icon` " "attribute that displays an icon in the filter button. The icon names are " "based on the default icon theme provided by Bootstrap." msgstr "" #: ../../source/configuration/settings.rst:1153 #: ../../source/configuration/settings.rst:1253 #: ../../source/configuration/settings.rst:1606 #: ../../source/configuration/settings.rst:1659 #: ../../source/configuration/settings.rst:1817 #: ../../source/configuration/settings.rst:1859 msgid "Example:" msgstr "" #: ../../source/configuration/settings.rst:1162 msgid "OPENSTACK_IMAGE_BACKEND" msgstr "" #: ../../source/configuration/settings.rst:1186 msgid "" "Used to customize features related to the image service, such as the list of " "supported image formats." msgstr "" #: ../../source/configuration/settings.rst:1190 msgid "Keystone" msgstr "" #: ../../source/configuration/settings.rst:1193 msgid "AUTHENTICATION_PLUGINS" msgstr "" #: ../../source/configuration/settings.rst:1206 msgid "" "A list of authentication plugins to be used. In most cases, there is no need " "to configure this." msgstr "" #: ../../source/configuration/settings.rst:1210 msgid "AUTHENTICATION_URLS" msgstr "" #: ../../source/configuration/settings.rst:1214 msgid "Default: ``['openstack_auth.urls']``" msgstr "" #: ../../source/configuration/settings.rst:1216 msgid "" "A list of modules from which to collate authentication URLs from. The " "default option adds URLs from the django-openstack-auth module however " "others will be required for additional authentication mechanisms." msgstr "" #: ../../source/configuration/settings.rst:1221 msgid "AVAILABLE_REGIONS" msgstr "" #: ../../source/configuration/settings.rst:1227 msgid "" "A list of tuples which define multiple regions. The tuple format is ``('http:" "//{{ keystone_host }}:5000/v3', '{{ region_name }}')``. If any regions are " "specified the login form will have a dropdown selector for authenticating to " "the appropriate region, and there will be a region switcher dropdown in the " "site header when logged in." msgstr "" #: ../../source/configuration/settings.rst:1233 msgid "" "You should also define `OPENSTACK_KEYSTONE_URL`_ to indicate which of the " "regions is the default one." msgstr "" #: ../../source/configuration/settings.rst:1238 msgid "DEFAULT_SERVICE_REGIONS" msgstr "" #: ../../source/configuration/settings.rst:1242 #: ../../source/configuration/settings.rst:1484 #: ../../source/configuration/settings.rst:1544 #: ../../source/configuration/settings.rst:1597 #: ../../source/configuration/settings.rst:1796 #: ../../source/configuration/settings.rst:1850 msgid "Default: ``{}``" msgstr "" #: ../../source/configuration/settings.rst:1244 msgid "" "The default service region is set on a per-endpoint basis, meaning that once " "the user logs into some Keystone endpoint, if a default service region is " "defined for it in this setting and exists within Keystone catalog, it will " "be set as the initial service region in this endpoint. By default it is an " "empty dictionary because upstream can neither predict service region names " "in a specific deployment, nor tell whether this behavior is desired. The key " "of the dictionary is a full url of a Keystone endpoint with version suffix, " "the value is a region name." msgstr "" #: ../../source/configuration/settings.rst:1262 msgid "ENABLE_CLIENT_TOKEN" msgstr "" #: ../../source/configuration/settings.rst:1268 msgid "" "This setting will Enable/Disable access to the Keystone Token to the browser." "" msgstr "" #: ../../source/configuration/settings.rst:1272 msgid "ENFORCE_PASSWORD_CHECK" msgstr "" #: ../../source/configuration/settings.rst:1278 msgid "" "This setting will display an 'Admin Password' field on the Change Password " "form to verify that it is indeed the admin logged-in who wants to change the " "password." msgstr "" #: ../../source/configuration/settings.rst:1283 msgid "KEYSTONE_PROVIDER_IDP_ID" msgstr "" #: ../../source/configuration/settings.rst:1287 msgid "Default: ``\"localkeystone\"``" msgstr "" #: ../../source/configuration/settings.rst:1289 msgid "" "This ID is only used for comparison with the service provider IDs. This ID " "should not match any service provider IDs." msgstr "" #: ../../source/configuration/settings.rst:1293 msgid "KEYSTONE_PROVIDER_IDP_NAME" msgstr "" #: ../../source/configuration/settings.rst:1297 msgid "Default: ``\"Local Keystone\"``" msgstr "" #: ../../source/configuration/settings.rst:1299 msgid "" "The Keystone Provider drop down uses Keystone to Keystone federation to " "switch between Keystone service providers. This sets the display name for " "the Identity Provider (dropdown display name)." msgstr "" #: ../../source/configuration/settings.rst:1304 msgid "OPENSTACK_KEYSTONE_ADMIN_ROLES" msgstr "" #: ../../source/configuration/settings.rst:1308 msgid "Default: ``[\"admin\"]``" msgstr "" #: ../../source/configuration/settings.rst:1310 msgid "" "The list of roles that have administrator privileges in this OpenStack " "installation. This check is very basic and essentially only works with " "keystone v2.0 and v3 with the default policy file. The setting assumes there " "is a common ``admin`` like role(s) across services. Example uses of this " "setting are:" msgstr "" #: ../../source/configuration/settings.rst:1316 msgid "to rename the ``admin`` role to ``cloud-admin``" msgstr "" #: ../../source/configuration/settings.rst:1317 msgid "" "allowing multiple roles to have administrative privileges, like " "``[\"admin\", \"cloud-admin\", \"net-op\"]``" msgstr "" #: ../../source/configuration/settings.rst:1321 msgid "OPENSTACK_KEYSTONE_BACKEND" msgstr "" #: ../../source/configuration/settings.rst:1338 msgid "" "A dictionary containing settings which can be used to identify the " "capabilities of the auth backend for Keystone." msgstr "" #: ../../source/configuration/settings.rst:1341 msgid "" "If Keystone has been configured to use LDAP as the auth backend then set " "``can_edit_user`` and ``can_edit_project`` to ``False`` and name to " "``\"ldap\"``." msgstr "" #: ../../source/configuration/settings.rst:1345 msgid "OPENSTACK_KEYSTONE_DEFAULT_DOMAIN" msgstr "" #: ../../source/configuration/settings.rst:1349 msgid "Default: ``\"Default\"``" msgstr "" #: ../../source/configuration/settings.rst:1351 msgid "" "Overrides the default domain used when running on single-domain model with " "Keystone V3. All entities will be created in the default domain." msgstr "" #: ../../source/configuration/settings.rst:1355 msgid "OPENSTACK_KEYSTONE_DEFAULT_ROLE" msgstr "" #: ../../source/configuration/settings.rst:1359 msgid "Default: ``\"_member_\"``" msgstr "" #: ../../source/configuration/settings.rst:1361 msgid "" "The name of the role which will be assigned to a user when added to a " "project. This value must correspond to an existing role name in Keystone. In " "general, the value should match the ``member_role_name`` defined in " "``keystone.conf``." msgstr "" #: ../../source/configuration/settings.rst:1366 msgid "OPENSTACK_KEYSTONE_DOMAIN_CHOICES" msgstr "" #: ../../source/configuration/settings.rst:1378 msgid "" "If `OPENSTACK_KEYSTONE_DOMAIN_DROPDOWN`_ is enabled, this option can be used " "to set the available domains to choose from. This is a list of pairs whose " "first value is the domain name and the second is the display name." msgstr "" #: ../../source/configuration/settings.rst:1383 msgid "OPENSTACK_KEYSTONE_DOMAIN_DROPDOWN" msgstr "" #: ../../source/configuration/settings.rst:1389 msgid "" "Set this to True if you want available domains displayed as a dropdown menu " "on the login screen. It is strongly advised NOT to enable this for public " "clouds, as advertising enabled domains to unauthenticated customers " "irresponsibly exposes private information. This should only be used for " "private clouds where the dashboard sits behind a corporate firewall." msgstr "" #: ../../source/configuration/settings.rst:1396 msgid "OPENSTACK_KEYSTONE_FEDERATION_MANAGEMENT" msgstr "" #: ../../source/configuration/settings.rst:1402 msgid "" "Set this to True to enable panels that provide the ability for users to " "manage Identity Providers (IdPs) and establish a set of rules to map " "federation protocol attributes to Identity API attributes. This extension " "requires v3.0+ of the Identity API." msgstr "" #: ../../source/configuration/settings.rst:1408 msgid "OPENSTACK_KEYSTONE_MULTIDOMAIN_SUPPORT" msgstr "" #: ../../source/configuration/settings.rst:1414 msgid "" "Set this to True if running on multi-domain model. When this is enabled, it " "will require user to enter the Domain name in addition to username for login." "" msgstr "" #: ../../source/configuration/settings.rst:1418 msgid "OPENSTACK_KEYSTONE_URL" msgstr "" #: ../../source/configuration/settings.rst:1424 msgid "Horizon's `OPENSTACK_HOST`_ documentation" msgstr "" #: ../../source/configuration/settings.rst:1426 msgid "Default: ``\"http://%s:5000/v3\" % OPENSTACK_HOST``" msgstr "" #: ../../source/configuration/settings.rst:1428 msgid "" "The full URL for the Keystone endpoint used for authentication. Unless you " "are using HTTPS, running your Keystone server on a nonstandard port, or " "using a nonstandard URL scheme you shouldn't need to touch this setting." msgstr "" #: ../../source/configuration/settings.rst:1433 msgid "OPENSTACK_TOKEN_HASH_ALGORITHM" msgstr "" #: ../../source/configuration/settings.rst:1437 msgid "Default: ``\"md5\"``" msgstr "" #: ../../source/configuration/settings.rst:1439 msgid "" "The hash algorithm to use for authentication tokens. This must match the " "hash algorithm that the identity (Keystone) server and the auth_token " "middleware are using. Allowed values are the algorithms supported by " "Python's hashlib library." msgstr "" #: ../../source/configuration/settings.rst:1445 msgid "OPENSTACK_TOKEN_HASH_ENABLED" msgstr "" #: ../../source/configuration/settings.rst:1451 msgid "" "PKI tokens currently work with hashing, and Keystone will soon deprecate " "usage of PKI tokens." msgstr "" #: ../../source/configuration/settings.rst:1456 msgid "" "Hashing tokens from Keystone keeps the Horizon session data smaller, but it " "doesn't work in some cases when using PKI tokens. Uncomment this value and " "set it to False if using PKI tokens and there are 401 errors due to token " "hashing." msgstr "" #: ../../source/configuration/settings.rst:1462 msgid "PASSWORD_EXPIRES_WARNING_THRESHOLD_DAYS" msgstr "" #: ../../source/configuration/settings.rst:1466 msgid "Default: ``-1``" msgstr "" #: ../../source/configuration/settings.rst:1468 msgid "" "Password will have an expiration date when using keystone v3 and enabling " "the feature. This setting allows you to set the number of days that the user " "will be alerted prior to the password expiration. Once the password expires " "keystone will deny the access and users must contact an admin to change " "their password. Setting this value to ``N`` days means the user will be " "alerted when the password expires in less than ``N+1`` days. ``-1`` disables " "the feature." msgstr "" #: ../../source/configuration/settings.rst:1476 msgid "PROJECT_TABLE_EXTRA_INFO" msgstr "" #: ../../source/configuration/settings.rst:1482 msgid "`USER_TABLE_EXTRA_INFO`_ for the equivalent setting on the Users table" msgstr "" #: ../../source/configuration/settings.rst:1486 msgid "" "Adds additional information for projects as extra attributes. Projects can " "have extra attributes as defined by Keystone v3. This setting allows those " "attributes to be shown in Horizon." msgstr "" #: ../../source/configuration/settings.rst:1490 #: ../../source/configuration/settings.rst:1550 msgid "For example:" msgstr "" #: ../../source/configuration/settings.rst:1499 msgid "SECURE_PROXY_ADDR_HEADER" msgstr "" #: ../../source/configuration/settings.rst:1503 msgid "" "If horizon is behind a proxy server and the proxy is configured, the IP " "address from request is passed using header variables inside the request. " "The header name depends on a proxy or a load-balancer. This setting " "specifies the name of the header with remote IP address. The main use is for " "authentication log (success or fail) displaing the IP address of the user. " "The commom value for this setting is ``HTTP_X_REAL_IP`` or " "``HTTP_X_FORWARDED_FOR``. If not present, then ``REMOTE_ADDR`` header is " "used. (``REMOTE_ADDR`` is the field of Django HttpRequest object which " "contains IP address of the client.)" msgstr "" #: ../../source/configuration/settings.rst:1514 msgid "TOKEN_DELETION_DISABLED" msgstr "" #: ../../source/configuration/settings.rst:1520 msgid "" "This setting allows deployers to control whether a token is deleted on log " "out. This can be helpful when there are often long running processes being " "run in the Horizon environment." msgstr "" #: ../../source/configuration/settings.rst:1525 msgid "TOKEN_TIMEOUT_MARGIN" msgstr "" #: ../../source/configuration/settings.rst:1527 msgid "Default: ``0``" msgstr "" #: ../../source/configuration/settings.rst:1529 msgid "" "A time margin in seconds to subtract from the real token's validity. An " "example use case is that the token can be valid once the middleware passed, " "and invalid (timed-out) during a view rendering and this generates " "authorization errors during the view rendering. By setting this value to a " "few seconds, you can avoid token expiration during a view rendering." msgstr "" #: ../../source/configuration/settings.rst:1536 msgid "USER_TABLE_EXTRA_INFO" msgstr "" #: ../../source/configuration/settings.rst:1542 msgid "" "`PROJECT_TABLE_EXTRA_INFO`_ for the equivalent setting on the Projects table" msgstr "" #: ../../source/configuration/settings.rst:1546 msgid "" "Adds additional information for users as extra attributes. Users can have " "extra attributes as defined by Keystone v3. This setting allows those " "attributes to be shown in Horizon." msgstr "" #: ../../source/configuration/settings.rst:1559 msgid "WEBSSO_CHOICES" msgstr "" #: ../../source/configuration/settings.rst:1573 msgid "" "This is the list of authentication mechanisms available to the user. It " "includes Keystone federation protocols such as OpenID Connect and SAML, and " "also keys that map to specific identity provider and federation protocol " "combinations (as defined in `WEBSSO_IDP_MAPPING`_). The list of choices is " "completely configurable, so as long as the id remains intact. Do not remove " "the credentials mechanism unless you are sure. Once removed, even admins " "will have no way to log into the system via the dashboard." msgstr "" #: ../../source/configuration/settings.rst:1582 msgid "WEBSSO_ENABLED" msgstr "" #: ../../source/configuration/settings.rst:1588 msgid "" "Enables keystone web single-sign-on if set to True. For this feature to " "work, make sure that you are using Keystone V3 and Django OpenStack Auth V1." "2.0 or later." msgstr "" #: ../../source/configuration/settings.rst:1593 msgid "WEBSSO_IDP_MAPPING" msgstr "" #: ../../source/configuration/settings.rst:1599 msgid "" "A dictionary of specific identity provider and federation protocol " "combinations. From the selected authentication mechanism, the value will be " "looked up as keys in the dictionary. If a match is found, it will redirect " "the user to a identity provider and federation protocol specific WebSSO " "endpoint in keystone, otherwise it will use the value as the protocol_id " "when redirecting to the WebSSO by protocol endpoint." msgstr "" #: ../../source/configuration/settings.rst:1625 msgid "" "The value is expected to be a tuple formatted as: (, )" msgstr "" #: ../../source/configuration/settings.rst:1628 msgid "WEBSSO_INITIAL_CHOICE" msgstr "" #: ../../source/configuration/settings.rst:1632 msgid "Default: ``\"credentials\"``" msgstr "" #: ../../source/configuration/settings.rst:1634 msgid "" "Specifies the default authentication mechanism. When user lands on the login " "page, this is the first choice they will see." msgstr "" #: ../../source/configuration/settings.rst:1638 msgid "Neutron" msgstr "" #: ../../source/configuration/settings.rst:1641 msgid "ALLOWED_PRIVATE_SUBNET_CIDR" msgstr "" #: ../../source/configuration/settings.rst:1654 msgid "" "A dictionary used to restrict user private subnet CIDR range. An empty list " "means that user input will not be restricted for a corresponding IP version. " "By default, there is no restriction for both IPv4 and IPv6." msgstr "" #: ../../source/configuration/settings.rst:1675 msgid "OPENSTACK_NEUTRON_NETWORK" msgstr "" #: ../../source/configuration/settings.rst:1698 msgid "" "A dictionary of settings which can be used to enable optional services " "provided by Neutron and configure Neutron specific features. The following " "options are available." msgstr "" #: ../../source/configuration/settings.rst:1703 msgid "default_dns_nameservers" msgstr "" #: ../../source/configuration/settings.rst:1707 msgid "Default: ``None`` (Empty)" msgstr "" #: ../../source/configuration/settings.rst:1709 msgid "" "Default DNS servers you would like to use when a subnet is created. This is " "only a default. Users can still choose a different list of dns servers." msgstr "" #: ../../source/configuration/settings.rst:1712 msgid "Example: ``[\"8.8.8.8\", \"8.8.4.4\", \"208.67.222.222\"]``" msgstr "" #: ../../source/configuration/settings.rst:1715 msgid "enable_distributed_router" msgstr "" #: ../../source/configuration/settings.rst:1721 msgid "" "Enable or disable Neutron distributed virtual router (DVR) feature in the " "Router panel. For the DVR feature to be enabled, this option needs to be set " "to True and your Neutron deployment must support DVR. Even when your Neutron " "plugin (like ML2 plugin) supports DVR feature, DVR feature depends on l3-" "agent configuration, so deployers should set this option appropriately " "depending on your deployment." msgstr "" #: ../../source/configuration/settings.rst:1729 msgid "enable_fip_topology_check" msgstr "" #: ../../source/configuration/settings.rst:1735 msgid "" "The Default Neutron implementation needs a router with a gateway to " "associate a FIP. So by default a topology check will be performed by horizon " "to list only VM ports attached to a network which is itself attached to a " "router with an external gateway. This is to prevent from setting a FIP to a " "port which will fail with an error. Some Neutron vendors do not require it. " "Some can even attach a FIP to any port (e.g.: OpenContrail) owned by a " "tenant. Set to False if you want to be able to associate a FIP to an " "instance on a subnet with no router if your Neutron backend allows it." msgstr "" #: ../../source/configuration/settings.rst:1746 msgid "enable_ha_router" msgstr "" #: ../../source/configuration/settings.rst:1752 msgid "" "Enable or disable HA (High Availability) mode in Neutron virtual router in " "the Router panel. For the HA router mode to be enabled, this option needs to " "be set to True and your Neutron deployment must support HA router mode. Even " "when your Neutron plugin (like ML2 plugin) supports HA router mode, the " "feature depends on l3-agent configuration, so deployers should set this " "option appropriately depending on your deployment." msgstr "" #: ../../source/configuration/settings.rst:1760 msgid "enable_ipv6" msgstr "" #: ../../source/configuration/settings.rst:1766 msgid "" "Enable or disable IPv6 support in the Network panels. When disabled, Horizon " "will only expose IPv4 configuration for networks." msgstr "" #: ../../source/configuration/settings.rst:1770 msgid "enable_quotas" msgstr "" #: ../../source/configuration/settings.rst:1774 msgid "" "Enable support for Neutron quotas feature. To make this feature work " "appropriately, you need to use Neutron plugins with quotas extension support " "and quota_driver should be DbQuotaDriver (default config)." msgstr "" #: ../../source/configuration/settings.rst:1779 msgid "enable_router" msgstr "" #: ../../source/configuration/settings.rst:1785 msgid "" "Enable (``True``) or disable (``False``) the panels and menus related to " "router and Floating IP features. This option only affects when Neutron is " "enabled. If your Neutron deployment has no support for Layer-3 features, or " "you do not wish to provide the Layer-3 features through the Dashboard, this " "should be set to ``False``." msgstr "" #: ../../source/configuration/settings.rst:1792 msgid "extra_provider_types" msgstr "" #: ../../source/configuration/settings.rst:1798 msgid "" "For use with the provider network extension. This is a dictionary to define " "extra provider network definitions. Network types supported by Neutron " "depend on the configured plugin. Horizon has predefined provider network " "types but horizon cannot cover all of them. If you are using a provider " "network type not defined in advance, you can add a definition through this " "setting." msgstr "" #: ../../source/configuration/settings.rst:1805 msgid "" "The **key** name of each item in this must be a network type used in the " "Neutron API. **value** should be a dictionary which contains the following " "items:" msgstr "" #: ../../source/configuration/settings.rst:1809 msgid "``display_name``: string displayed in the network creation form." msgstr "" #: ../../source/configuration/settings.rst:1810 msgid "" "``require_physical_network``: a boolean parameter which indicates this " "network type requires a physical network." msgstr "" #: ../../source/configuration/settings.rst:1812 msgid "" "``require_segmentation_id``: a boolean parameter which indicates this " "network type requires a segmentation ID. If True, a valid segmentation ID " "range must be configured in ``segmentation_id_range`` settings above." msgstr "" #: ../../source/configuration/settings.rst:1830 msgid "physical_networks" msgstr "" #: ../../source/configuration/settings.rst:1836 msgid "" "Default to an empty list and the physical network field on the admin create " "network modal will be a regular input field where users can type in the name " "of the physical network to be used. If it is set to a list of available " "physical networks, the physical network field will be shown as a dropdown " "menu where users can select a physical network to be used." msgstr "" #: ../../source/configuration/settings.rst:1843 msgid "Example: ``['default', 'test']``" msgstr "" #: ../../source/configuration/settings.rst:1846 msgid "segmentation_id_range" msgstr "" #: ../../source/configuration/settings.rst:1852 msgid "" "For use with the provider network extension. This is a dictionary where each " "key is a provider network type and each value is a list containing two " "numbers. The first number is the minimum segmentation ID that is valid. The " "second number is the maximum segmentation ID. Pertains only to the vlan, " "gre, and vxlan network types. By default this option is not provided and " "each minimum and maximum value will be the default for the provider network " "type." msgstr "" #: ../../source/configuration/settings.rst:1869 msgid "supported_provider_types" msgstr "" #: ../../source/configuration/settings.rst:1873 msgid "Default: ``[\"*\"]``" msgstr "" #: ../../source/configuration/settings.rst:1875 msgid "" "For use with the provider network extension. Use this to explicitly set " "which provider network types are supported. Only the network types in this " "list will be available to choose from when creating a network. Network types " "defined in Horizon or defined in `extra_provider_types`_ settings can be " "specified in this list. As of the Newton release, the network types defined " "in Horizon include network types supported by Neutron ML2 plugin with Open " "vSwitch driver (``local``, ``flat``, ``vlan``, ``gre``, ``vxlan`` and " "``geneve``) and supported by Midonet plugin (``midonet`` and ``uplink``). " "``[\"*\"]`` means that all provider network types supported by Neutron ML2 " "plugin will be available to choose from." msgstr "" #: ../../source/configuration/settings.rst:1887 msgid "Example: ``['local', 'flat', 'gre']``" msgstr "" #: ../../source/configuration/settings.rst:1890 msgid "supported_vnic_types" msgstr "" #: ../../source/configuration/settings.rst:1896 msgid "" "Added ``virtio-forwarder`` VNIC type Clarified VNIC type availability for " "users and operators" msgstr "" #: ../../source/configuration/settings.rst:1900 msgid "Default ``['*']``" msgstr "" #: ../../source/configuration/settings.rst:1902 msgid "" "For use with the port binding extension. Use this to explicitly set which " "VNIC types are available for users to choose from, when creating or editing " "a port. The VNIC types actually supported are determined by resource " "availability and Neutron ML2 plugin support. Currently, error reporting for " "users selecting an incompatible or unavailable VNIC type is restricted to " "receiving a message from the scheduler that the instance cannot spawn " "because of insufficient resources. VNIC types include ``normal``, " "``direct``, ``direct-physical``, ``macvtap``, ``baremetal`` and ``virtio-" "forwarder``. By default all VNIC types will be available to choose from." msgstr "" #: ../../source/configuration/settings.rst:1913 msgid "Example: ``['normal', 'direct']``" msgstr "" #: ../../source/configuration/settings.rst:1915 msgid "" "To disable VNIC type selection, set an empty list (``[]``) or ``None``." msgstr "" #: ../../source/configuration/settings.rst:1918 msgid "Nova" msgstr "" #: ../../source/configuration/settings.rst:1921 msgid "CREATE_INSTANCE_FLAVOR_SORT" msgstr "" #: ../../source/configuration/settings.rst:1933 msgid "" "When launching a new instance the default flavor is sorted by RAM usage in " "ascending order. You can customize the sort order by: id, name, ram, disk " "and vcpus. Additionally, you can insert any custom callback function. You " "can also provide a flag for reverse sort. See the description in " "local_settings.py.example for more information." msgstr "" #: ../../source/configuration/settings.rst:1940 msgid "This example sorts flavors by vcpus in descending order:" msgstr "" #: ../../source/configuration/settings.rst:1950 msgid "CONSOLE_TYPE" msgstr "" #: ../../source/configuration/settings.rst:1956 msgid "Added the ``None`` option, which deactivates the in-browser console" msgstr "" #: ../../source/configuration/settings.rst:1960 msgid "Added the ``SERIAL`` option" msgstr "" #: ../../source/configuration/settings.rst:1964 msgid "Added the ``MKS`` option" msgstr "" #: ../../source/configuration/settings.rst:1966 msgid "Default: ``\"AUTO\"``" msgstr "" #: ../../source/configuration/settings.rst:1968 msgid "" "This setting specifies the type of in-browser console used to access the VMs." " Valid values are ``\"AUTO\"``, ``\"VNC\"``, ``\"SPICE\"``, ``\"RDP\"``, " "``\"SERIAL\"``, ``\"MKS\"``, and ``None``." msgstr "" #: ../../source/configuration/settings.rst:1973 msgid "ENABLE_FLAVOR_EDIT" msgstr "" #: ../../source/configuration/settings.rst:1981 msgid "This setting enables the ability to edit flavors." msgstr "" #: ../../source/configuration/settings.rst:1985 msgid "" "Historically, Horizon has provided the ability to edit Flavors by deleting " "and creating a new one with the same information. This is not supported in " "the Nova API and causes unexpected issues and breakages. To avoid breaking " "standard deprecation procedure, this code is still in Horizon, but disabled " "by default. It will be removed during the 14.0.0 ('R') release cycle." msgstr "" #: ../../source/configuration/settings.rst:1991 msgid "" "See `this email thread `_ for further information." msgstr "" #: ../../source/configuration/settings.rst:1996 msgid "INSTANCE_LOG_LENGTH" msgstr "" #: ../../source/configuration/settings.rst:2000 msgid "Default: ``35``" msgstr "" #: ../../source/configuration/settings.rst:2002 msgid "" "This setting enables you to change the default number of lines displayed for " "the log of an instance. Valid value must be a positive integer." msgstr "" #: ../../source/configuration/settings.rst:2007 msgid "LAUNCH_INSTANCE_DEFAULTS" msgstr "" #: ../../source/configuration/settings.rst:2013 msgid "" "Added the ``disable_image``, ``disable_instance_snapshot``, " "``disable_volume`` and ``disable_volume_snapshot`` options." msgstr "" #: ../../source/configuration/settings.rst:2018 msgid "Added the ``create_volume`` option." msgstr "" #: ../../source/configuration/settings.rst:2034 msgid "" "A dictionary of settings which can be used to provide the default values for " "properties found in the Launch Instance modal. An explanation of each " "setting is provided below." msgstr "" #: ../../source/configuration/settings.rst:2039 msgid "config_drive" msgstr "" #: ../../source/configuration/settings.rst:2045 msgid "" "This setting specifies the default value for the Configuration Drive " "property." msgstr "" #: ../../source/configuration/settings.rst:2048 msgid "create_volume" msgstr "" #: ../../source/configuration/settings.rst:2054 msgid "" "This setting allows you to specify the default value for the option of " "creating a new volume in the workflow for image and instance snapshot " "sources." msgstr "" #: ../../source/configuration/settings.rst:2058 msgid "disable_image" msgstr "" #: ../../source/configuration/settings.rst:2064 msgid "" "This setting disables Images as a valid boot source for launching instances. " "Image sources won't show up in the Launch Instance modal." msgstr "" #: ../../source/configuration/settings.rst:2068 msgid "disable_instance_snapshot" msgstr "" #: ../../source/configuration/settings.rst:2074 msgid "" "This setting disables Snapshots as a valid boot source for launching " "instances. Snapshots sources won't show up in the Launch Instance modal." msgstr "" #: ../../source/configuration/settings.rst:2078 msgid "disable_volume" msgstr "" #: ../../source/configuration/settings.rst:2084 msgid "" "This setting disables Volumes as a valid boot source for launching instances." " Volumes sources won't show up in the Launch Instance modal." msgstr "" #: ../../source/configuration/settings.rst:2088 msgid "disable_volume_snapshot" msgstr "" #: ../../source/configuration/settings.rst:2094 msgid "" "This setting disables Volume Snapshots as a valid boot source for launching " "instances. Volume Snapshots sources won't show up in the Launch Instance " "modal." msgstr "" #: ../../source/configuration/settings.rst:2098 msgid "enable_scheduler_hints" msgstr "" #: ../../source/configuration/settings.rst:2104 msgid "" "This setting specifies whether or not Scheduler Hints can be provided when " "launching an instance." msgstr "" #: ../../source/configuration/settings.rst:2108 msgid "LAUNCH_INSTANCE_LEGACY_ENABLED" msgstr "" #: ../../source/configuration/settings.rst:2114 msgid "The default value for this setting has been changed to ``False``" msgstr "" #: ../../source/configuration/settings.rst:2118 msgid "This setting enables the Python Launch Instance workflow." msgstr "" #: ../../source/configuration/settings.rst:2122 msgid "" "It is possible to run both the AngularJS and Python workflows " "simultaneously, so the other may be need to be toggled with " "`LAUNCH_INSTANCE_NG_ENABLED`_" msgstr "" #: ../../source/configuration/settings.rst:2126 msgid "LAUNCH_INSTANCE_NG_ENABLED" msgstr "" #: ../../source/configuration/settings.rst:2132 msgid "The default value for this setting has been changed to ``True``" msgstr "" #: ../../source/configuration/settings.rst:2136 msgid "This setting enables the AngularJS Launch Instance workflow." msgstr "" #: ../../source/configuration/settings.rst:2140 msgid "" "It is possible to run both the AngularJS and Python workflows " "simultaneously, so the other may be need to be toggled with " "`LAUNCH_INSTANCE_LEGACY_ENABLED`_" msgstr "" #: ../../source/configuration/settings.rst:2144 msgid "OPENSTACK_ENABLE_PASSWORD_RETRIEVE" msgstr "" #: ../../source/configuration/settings.rst:2148 msgid "Default: ``\"False\"``" msgstr "" #: ../../source/configuration/settings.rst:2150 msgid "" "When set, enables the instance action \"Retrieve password\" allowing " "password retrieval from metadata service." msgstr "" #: ../../source/configuration/settings.rst:2154 msgid "OPENSTACK_HYPERVISOR_FEATURES" msgstr "" #: ../../source/configuration/settings.rst:2160 msgid "" "``can_set_mount_point`` and ``can_set_password`` now default to ``False``" msgstr "" #: ../../source/configuration/settings.rst:2173 msgid "" "A dictionary containing settings which can be used to identify the " "capabilities of the hypervisor for Nova." msgstr "" #: ../../source/configuration/settings.rst:2176 msgid "" "The Xen Hypervisor has the ability to set the mount point for volumes " "attached to instances (other Hypervisors currently do not). Setting " "``can_set_mount_point`` to ``True`` will add the option to set the mount " "point from the UI." msgstr "" #: ../../source/configuration/settings.rst:2181 msgid "" "Setting ``can_set_password`` to ``True`` will enable the option to set an " "administrator password when launching or rebuilding an instance." msgstr "" #: ../../source/configuration/settings.rst:2184 msgid "" "Setting ``requires_keypair`` to ``True`` will require users to select a key " "pair when launching an instance." msgstr "" #: ../../source/configuration/settings.rst:2187 msgid "" "Setting ``enable_quotas`` to ``False`` will make Horizon treat all Nova " "quotas as disabled, thus it won't try to modify them. By default, quotas are " "enabled." msgstr "" #: ../../source/configuration/settings.rst:2192 msgid "OPENSTACK_INSTANCE_RETRIEVE_IP_ADDRESSES" msgstr "" #: ../../source/configuration/settings.rst:2198 msgid "" "This settings controls whether IP addresses of servers are retrieved from " "neutron in the project instance table. Setting this to ``False`` may " "mitigate a performance issue in the project instance table in large " "deployments." msgstr "" #: ../../source/configuration/settings.rst:2202 msgid "" "If your deployment has no support of floating IP like provider network " "scenario, you can set this to ``False`` in most cases. If your deployment " "supports floating IP, read the detail below and understand the under-the-" "hood before setting this to ``False``." msgstr "" #: ../../source/configuration/settings.rst:2207 msgid "" "Nova has a mechanism to cache network info but it is not fast enough in some " "cases. For example, when a user associates a floating IP or updates an IP " "address of an server port, it is not reflected to the nova network info " "cache immediately. This means an action which a user makes from the horizon " "instance table is not reflected into the table content just after the action." " To avoid this, horizon retrieves IP address info from neutron when " "retrieving a list of servers from nova." msgstr "" #: ../../source/configuration/settings.rst:2215 msgid "" "On the other hand, this operation requires a full list of neutron ports and " "can potentially lead to a performance issue in large deployments (`bug " "1722417 `__). This issue " "can be avoided by skipping querying IP addresses to neutron and setting this " "to ``False`` achieves this. Note that when disabling the query to neutron it " "takes some time until associated floating IPs are visible in the project " "instance table and users may reload the table to check them." msgstr "" #: ../../source/configuration/settings.rst:2225 msgid "OPENSTACK_NOVA_EXTENSIONS_BLACKLIST" msgstr "" #: ../../source/configuration/settings.rst:2231 msgid "" "Ignore all listed Nova extensions, and behave as if they were unsupported. " "Can be used to selectively disable certain costly extensions for performance " "reasons." msgstr "" #: ../../source/configuration/settings.rst:2236 msgid "Sahara" msgstr "" #: ../../source/configuration/settings.rst:2240 msgid "" "The Sahara dashboard was removed from Horizon during the Newton cycle, and " "any settings here should be considered legacy. For more up to date " "information, see the `Sahara Dashboard repo `_" msgstr "" #: ../../source/configuration/settings.rst:2246 msgid "SAHARA_AUTO_IP_ALLOCATION_ENABLED" msgstr "" #: ../../source/configuration/settings.rst:2252 msgid "Default: ``False``" msgstr "" #: ../../source/configuration/settings.rst:2254 msgid "" "This setting notifies the Data Processing (Sahara) system whether or not " "automatic IP allocation is enabled. You would want to set this to ``True`` " "if you were running Nova Networking with ``auto_assign_floating_ip`` set to " "``True``." msgstr "" #: ../../source/configuration/settings.rst:2260 msgid "Swift" msgstr "" #: ../../source/configuration/settings.rst:2263 msgid "SWIFT_FILE_TRANSFER_CHUNK_SIZE" msgstr "" #: ../../source/configuration/settings.rst:2267 msgid "Default: ``512 * 1024``" msgstr "" #: ../../source/configuration/settings.rst:2269 msgid "" "This setting specifies the size of the chunk (in bytes) for downloading " "objects from Swift. Do not make it very large (higher than several dozens of " "Megabytes, exact number depends on your connection speed), otherwise you may " "encounter socket timeout. The default value is 524288 bytes (or 512 " "Kilobytes)." msgstr "" #: ../../source/configuration/settings.rst:2275 msgid "Trove" msgstr "" #: ../../source/configuration/settings.rst:2279 msgid "" "The Trove dashboard was removed from Horizon during the Newton cycle, and " "any settings here should be considered legacy. For more up to date " "information, see the `Trove Dashboard repo `_" msgstr "" #: ../../source/configuration/settings.rst:2285 msgid "TROVE_ADD_DATABASE_PERMS" msgstr "" #: ../../source/configuration/settings.rst:2293 msgid "" "Trove database extension support. By default, support for creating databases " "on database instances is turned on. To disable this extensions set the " "permission to something unusable such as ``[!]``." msgstr "" #: ../../source/configuration/settings.rst:2298 msgid "TROVE_ADD_USER_PERMS" msgstr "" #: ../../source/configuration/settings.rst:2306 msgid "" "Trove users extension support. By default, support for creating users on " "database instances is turned on. To disable this extensions set the " "permission to something unusable such as ``[!]``." msgstr "" #: ../../source/configuration/settings.rst:2311 msgid "Django Settings" msgstr "" #: ../../source/configuration/settings.rst:2315 msgid "" "This is not meant to be anywhere near a complete list of settings for Django." " You should always consult the `upstream documentation `_, especially with regards to " "deployment considerations and security best-practices." msgstr "" #: ../../source/configuration/settings.rst:2321 msgid "ADD_INSTALLED_APPS" msgstr "" #: ../../source/configuration/settings.rst:2327 msgid "" "`Django's INSTALLED_APPS documentation `_" msgstr "" #: ../../source/configuration/settings.rst:2330 msgid "" "A list of Django applications to be prepended to the ``INSTALLED_APPS`` " "setting. Allows extending the list of installed applications without having " "to override it completely." msgstr "" #: ../../source/configuration/settings.rst:2335 msgid "ALLOWED_HOSTS" msgstr "" #: ../../source/configuration/settings.rst:2341 msgid "" "`Django's ALLOWED_HOSTS documentation `_" msgstr "" #: ../../source/configuration/settings.rst:2344 msgid "Default: ``['localhost']``" msgstr "" #: ../../source/configuration/settings.rst:2346 msgid "" "This list should contain names (or IP addresses) of the host running the " "dashboard; if it's being accessed via name, the DNS name (and probably short-" "name) should be added, if it's accessed via IP address, that should be added." " The setting may contain more than one entry." msgstr "" #: ../../source/configuration/settings.rst:2353 msgid "" "ALLOWED_HOSTS is required. If Horizon is running in production (DEBUG is " "False), set this with the list of host/domain names that the application can " "serve. For more information see `Django's Allowed Hosts documentation `_" msgstr "" #: ../../source/configuration/settings.rst:2361 msgid "DEBUG" msgstr "" #: ../../source/configuration/settings.rst:2367 msgid "" "`Django's DEBUG documentation `_" msgstr "" #: ../../source/configuration/settings.rst:2372 msgid "" "Controls whether unhandled exceptions should generate a generic 500 response " "or present the user with a pretty-formatted debug information page." msgstr "" #: ../../source/configuration/settings.rst:2375 msgid "When set, `CACHED_TEMPLATE_LOADERS`_ will not be cached." msgstr "" #: ../../source/configuration/settings.rst:2377 msgid "" "This setting should **always** be set to ``False`` for production " "deployments as the debug page can display sensitive information to users and " "attackers alike." msgstr "" #: ../../source/configuration/settings.rst:2382 msgid "SECRET_KEY" msgstr "" #: ../../source/configuration/settings.rst:2388 msgid "" "`Django's SECRET_KEY documentation `_" msgstr "" #: ../../source/configuration/settings.rst:2391 msgid "" "This should absolutely be set to a unique (and secret) value for your " "deployment. Unless you are running a load-balancer with multiple Horizon " "installations behind it, each Horizon instance should have a unique secret " "key." msgstr "" #: ../../source/configuration/settings.rst:2397 msgid "Setting a custom secret key:" msgstr "" #: ../../source/configuration/settings.rst:2399 msgid "" "You can either set it to a specific value or you can let Horizon generate a " "default secret key that is unique on this machine, regardless of the amount " "of Python WSGI workers (if used behind Apache+mod_wsgi). However, there may " "be situations where you would want to set this explicitly, e.g. when " "multiple dashboard instances are distributed on different machines (usually " "behind a load-balancer). Either you have to make sure that a session gets " "all requests routed to the same dashboard instance or you set the same " "SECRET_KEY for all of them." msgstr "" #: ../../source/configuration/settings.rst:2415 msgid "" "The ``local_settings.py.example`` file includes a quick-and-easy way to " "generate a secret key for a single installation." msgstr "" #: ../../source/configuration/settings.rst:2419 msgid "STATIC_ROOT" msgstr "" #: ../../source/configuration/settings.rst:2425 msgid "" "`Django's STATIC_ROOT documentation `_" msgstr "" #: ../../source/configuration/settings.rst:2428 msgid "Default: ``/static``" msgstr "" #: ../../source/configuration/settings.rst:2430 msgid "" "The absolute path to the directory where static files are collected when " "collectstatic is run." msgstr "" #: ../../source/configuration/settings.rst:2434 msgid "STATIC_URL" msgstr "" #: ../../source/configuration/settings.rst:2440 msgid "" "`Django's STATIC_URL documentation `_" msgstr "" #: ../../source/configuration/settings.rst:2443 msgid "Default: ``/static/``" msgstr "" #: ../../source/configuration/settings.rst:2445 msgid "URL that refers to files in `STATIC_ROOT`_." msgstr "" #: ../../source/configuration/settings.rst:2447 msgid "By default this value is ``WEBROOT/static/``." msgstr "" #: ../../source/configuration/settings.rst:2449 msgid "" "This value can be changed from the default. When changed, the alias in your " "webserver configuration should be updated to match." msgstr "" #: ../../source/configuration/settings.rst:2454 msgid "The value for STATIC_URL must end in '/'." msgstr "" #: ../../source/configuration/settings.rst:2456 msgid "" "This value is also available in the scss namespace with the variable name " "$static_url. Make sure you run ``python manage.py collectstatic`` and " "``python manage.py compress`` after any changes to this value in settings.py." "" msgstr "" #: ../../source/configuration/settings.rst:2461 msgid "TEMPLATES" msgstr "" #: ../../source/configuration/settings.rst:2467 msgid "" "`Django's TEMPLATES documentation `_" msgstr "" #: ../../source/configuration/settings.rst:2470 msgid "" "Horizon's usage of the ``TEMPLATES`` involves 3 further settings below; it " "is generally advised to use those before attempting to alter the " "``TEMPLATES`` setting itself." msgstr "" #: ../../source/configuration/settings.rst:2475 msgid "ADD_TEMPLATE_LOADERS" msgstr "" #: ../../source/configuration/settings.rst:2479 msgid "" "Template loaders defined here will be loaded at the end of " "`TEMPLATE_LOADERS`_, after the `CACHED_TEMPLATE_LOADERS`_ and will never " "have a cached output." msgstr "" #: ../../source/configuration/settings.rst:2483 msgid "CACHED_TEMPLATE_LOADERS" msgstr "" #: ../../source/configuration/settings.rst:2487 msgid "" "Template loaders defined here will have their output cached if `DEBUG`_ is " "set to ``False``." msgstr "" #: ../../source/configuration/settings.rst:2491 msgid "TEMPLATE_LOADERS" msgstr "" #: ../../source/configuration/settings.rst:2495 msgid "" "These template loaders will be the first loaders and get loaded before the " "CACHED_TEMPLATE_LOADERS. Use ADD_TEMPLATE_LOADERS if you want to add loaders " "at the end and not cache loaded templates. After the whole settings process " "has gone through, TEMPLATE_LOADERS will be:" msgstr "" #: ../../source/configuration/themes.rst:3 msgid "Themes" msgstr "" #: ../../source/configuration/themes.rst:5 msgid "" "As of the Kilo release, styling for the OpenStack Dashboard can be altered " "through the use of a theme. A theme is a directory containing a ``_variables." "scss`` file to override the color codes used throughout the SCSS and a " "``_styles.scss`` file with additional styles to load after dashboard styles " "have loaded." msgstr "" #: ../../source/configuration/themes.rst:11 msgid "" "As of the Mitaka release, Horizon can be configured to run with multiple " "themes available at run time. It uses a browser cookie to allow users to " "toggle between the configured themes. By default, Horizon is configured " "with the two standard themes available: 'default' and 'material'." msgstr "" #: ../../source/configuration/themes.rst:16 msgid "" "To configure or alter the available themes, set ``AVAILABLE_THEMES`` in " "``local_settings.py`` to a list of tuples, such that ``('name', 'label', " "'path')``" msgstr "" #: ../../source/configuration/themes.rst:21 msgid "The key by which the theme value is stored within the cookie" msgstr "" #: ../../source/configuration/themes.rst:21 msgid "``name``" msgstr "" #: ../../source/configuration/themes.rst:24 msgid "The label shown in the theme toggle under the User Menu" msgstr "" #: ../../source/configuration/themes.rst:24 msgid "``label``" msgstr "" #: ../../source/configuration/themes.rst:27 msgid "" "The directory location for the theme. The path must be relative to the " "``openstack_dashboard`` directory or an absolute path to an accessible " "location on the file system" msgstr "" #: ../../source/configuration/themes.rst:29 msgid "``path``" msgstr "" #: ../../source/configuration/themes.rst:31 msgid "" "To use a custom theme, set ``AVAILABLE_THEMES`` in ``local_settings.py`` to " "a list of themes. If you wish to run in a mode similar to legacy Horizon, " "set ``AVAILABLE_THEMES`` with a single tuple, and the theme toggle will not " "be available at all through the application to allow user configuration " "themes." msgstr "" #: ../../source/configuration/themes.rst:36 msgid "For example, a configuration with multiple themes::" msgstr "" #: ../../source/configuration/themes.rst:43 msgid "A configuration with a single theme::" msgstr "" #: ../../source/configuration/themes.rst:49 msgid "" "Both the Dashboard custom variables and Bootstrap variables can be " "overridden. For a full list of the Dashboard SCSS variables that can be " "changed, see the variables file at ``openstack_dashboard/static/dashboard/" "scss/_variables.scss``." msgstr "" #: ../../source/configuration/themes.rst:54 msgid "" "In order to build a custom theme, both ``_variables.scss`` and ``_styles." "scss`` are required and ``_variables.scss`` must provide all the default " "Bootstrap variables." msgstr "" #: ../../source/configuration/themes.rst:59 msgid "Inherit from an Existing Theme" msgstr "" #: ../../source/configuration/themes.rst:61 msgid "" "Custom themes must implement all of the Bootstrap variables required by " "Horizon in ``_variables.scss`` and ``_styles.scss``. To make this easier, " "you can inherit the variables needed in the default theme and only override " "those that you need to customize. To inherit from the default theme, put " "this in your theme's ``_variables.scss``::" msgstr "" #: ../../source/configuration/themes.rst:69 msgid "" "Once you have made your changes you must re-generate the static files with:" msgstr "" #: ../../source/configuration/themes.rst:75 msgid "" "By default, all of the themes configured by ``AVAILABLE_THEMES`` setting are " "collected by horizon during the `collectstatic` process. By default, the " "themes are collected into the dynamic `static/themes` directory, but this " "location can be customized via the ``local_settings.py`` variable: " "``THEME_COLLECTION_DIR``" msgstr "" #: ../../source/configuration/themes.rst:80 msgid "" "Once collected, any theme configured via ``AVAILABLE_THEMES`` is available " "to inherit from by importing its variables and styles from its collection " "directory. The following is an example of inheriting from the material " "theme::" msgstr "" #: ../../source/configuration/themes.rst:87 msgid "" "All themes will need to be configured in ``AVAILABLE_THEMES`` to allow " "inheritance. If you wish to inherit from a theme, but not show that theme " "as a selectable option in the theme picker widget, then simply configure the " "``SELECTABLE_THEMES`` to exclude the parent theme. ``SELECTABLE_THEMES`` " "must be of the same format as ``AVAILABLE_THEMES``. It defaults to " "``AVAILABLE_THEMES`` if it is not set explicitly." msgstr "" #: ../../source/configuration/themes.rst:95 msgid "Bootswatch" msgstr "" #: ../../source/configuration/themes.rst:97 msgid "" "Horizon packages the Bootswatch SCSS files for use with its ``material`` " "theme. Because of this, it is simple to use an existing Bootswatch theme as " "a base. This is due to the fact that Bootswatch is loaded as a 3rd party " "static asset, and therefore is automatically collected into the `static` " "directory in `/horizon/lib/`. The following is an example of how to inherit " "from Bootswatch's ``darkly`` theme::" msgstr "" #: ../../source/configuration/themes.rst:109 msgid "Organizing Your Theme Directory" msgstr "" #: ../../source/configuration/themes.rst:111 msgid "" "A custom theme directory can be organized differently, depending on the " "level of customization that is desired, as it can include static files as " "well as Django templates. It can include special subdirectories that will " "be used differently: ``static``, ``templates`` and ``img``." msgstr "" #: ../../source/configuration/themes.rst:117 msgid "The ``static`` Folder" msgstr "" #: ../../source/configuration/themes.rst:119 msgid "" "If the theme folder contains a sub-folder called ``static``, then that sub " "folder will be used as the **static root of the theme**. I.e., Horizon will " "look in that sub-folder for the _variables.scss and _styles.scss files. The " "contents of this folder will also be served up at ``/static/custom``." msgstr "" #: ../../source/configuration/themes.rst:125 msgid "The ``templates`` Folder" msgstr "" #: ../../source/configuration/themes.rst:127 msgid "" "If the theme folder contains a sub-folder ``templates``, then the path to " "that sub-folder will be prepended to the ``TEMPLATE_DIRS`` tuple to allow " "for theme specific template customizations." msgstr "" #: ../../source/configuration/themes.rst:132 msgid "Using the ``templates`` Folder" msgstr "" #: ../../source/configuration/themes.rst:134 msgid "" "Any Django template that is used in Horizon can be overridden through a " "theme. This allows highly customized user experiences to exist within the " "scope of different themes. Any template that is overridden must adhere to " "the same directory structure that the extending template expects." msgstr "" #: ../../source/configuration/themes.rst:139 msgid "" "For example, if you wish to customize the sidebar, Horizon expects the " "template to live at ``horizon/_sidebar.html``. You would need to duplicate " "that directory structure under your templates directory, such that your " "override would live at ``{ theme_path }/templates/horizon/_sidebar.html``." msgstr "" #: ../../source/configuration/themes.rst:145 msgid "The ``img`` Folder" msgstr "" #: ../../source/configuration/themes.rst:147 msgid "" "If the static root of the theme folder contains an ``img`` directory, then " "all images that make use of the {% themable_asset %} templatetag can be " "overridden." msgstr "" #: ../../source/configuration/themes.rst:151 msgid "" "These assets include logo.svg, splash-logo.svg and favicon.ico, however " "overriding the SVG/GIF assets used by Heat within the `dashboard/img` folder " "is not currently supported." msgstr "" #: ../../source/configuration/themes.rst:156 msgid "Customizing the Logo" msgstr "" #: ../../source/configuration/themes.rst:159 msgid "Simple" msgstr "" #: ../../source/configuration/themes.rst:161 msgid "" "If you wish to customize the logo that is used on the splash screen or in " "the top navigation bar, then you need to create an ``img`` directory under " "your theme's static root directory and place your custom ``logo.svg`` or " "``logo-splash.svg`` within it." msgstr "" #: ../../source/configuration/themes.rst:166 msgid "" "If you wish to override the ``logo.svg`` using the previous method, and if " "the image used is larger than the height of the top navigation, then the " "image will be constrained to fit within the height of nav. You can " "customize the height of the top navigation bar by customizing the SCSS " "variable: ``$navbar-height``. If the image's height is smaller than the " "navbar height, then the image will retain its original resolution and size, " "and simply be centered vertically in the available space." msgstr "" #: ../../source/configuration/themes.rst:174 msgid "" "Prior to the Kilo release the images files inside of Horizon needed to be " "replaced by your images files or the Horizon stylesheets needed to be " "altered to point to the location of your image." msgstr "" #: ../../source/configuration/themes.rst:179 msgid "Advanced" msgstr "" #: ../../source/configuration/themes.rst:181 msgid "" "If you need to do more to customize the logo than simply replacing the " "existing PNG, then you can also override the _brand.html through a custom " "theme. To use this technique, simply add a ``templates/header/_brand.html`` " "to the root of your custom theme, and add markup directly to the file. For " "an example of how to do this, see ``openstack_dashboard/themes/material/" "templates/header/_brand.html``." msgstr "" #: ../../source/configuration/themes.rst:188 msgid "" "The splash / login panel can also be customized by adding ``templates/auth/" "_splash.html``. See ``openstack_dashboard/themes/material/templates/auth/" "_splash.html`` for an example." msgstr ""