--- a/ProjectDjango/Documentation/source/Plugin_Project_Django.PluginProjectDjango.html Sat May 23 11:14:54 2020 +0200
+++ b/ProjectDjango/Documentation/source/Plugin_Project_Django.PluginProjectDjango.html Mon Jun 22 19:32:12 2020 +0200
@@ -18,309 +18,405 @@
</style>
</head>
-<body><a NAME="top" ID="top"></a>
+<body>
+<a NAME="top" ID="top"></a>
<h1>Plugin_Project_Django.PluginProjectDjango</h1>
+
<p>
Module implementing the Django project plugin.
</p>
<h3>Global Attributes</h3>
+
<table>
-<tr><td>author</td></tr><tr><td>autoactivate</td></tr><tr><td>className</td></tr><tr><td>deactivateable</td></tr><tr><td>djangoPluginObject</td></tr><tr><td>error</td></tr><tr><td>longDescription</td></tr><tr><td>name</td></tr><tr><td>needsRestart</td></tr><tr><td>packageName</td></tr><tr><td>pyqtApi</td></tr><tr><td>python2Compatible</td></tr><tr><td>shortDescription</td></tr><tr><td>version</td></tr>
+<tr><td>author</td></tr><tr><td>autoactivate</td></tr><tr><td>className</td></tr><tr><td>deactivateable</td></tr><tr><td>djangoPluginObject</td></tr><tr><td>error</td></tr><tr><td>longDescription</td></tr><tr><td>name</td></tr><tr><td>needsRestart</td></tr><tr><td>packageName</td></tr><tr><td>pyqtApi</td></tr><tr><td>shortDescription</td></tr><tr><td>version</td></tr>
</table>
<h3>Classes</h3>
+
<table>
+
<tr>
<td><a href="#ProjectDjangoPlugin">ProjectDjangoPlugin</a></td>
<td>Class implementing the Django project plugin.</td>
</tr>
</table>
<h3>Functions</h3>
+
<table>
+
<tr>
<td><a href="#apiFiles">apiFiles</a></td>
<td>Module function to return the API files made available by this plugin.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#createDjangoPage">createDjangoPage</a></td>
<td>Module function to create the Django configuration page.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#getConfigData">getConfigData</a></td>
<td>Module function returning data as required by the configuration dialog.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#prepareUninstall">prepareUninstall</a></td>
<td>Module function to prepare for an uninstallation.</td>
</tr>
</table>
-<hr /><hr />
+<hr />
+<hr />
<a NAME="ProjectDjangoPlugin" ID="ProjectDjangoPlugin"></a>
<h2>ProjectDjangoPlugin</h2>
+
<p>
Class implementing the Django project plugin.
</p>
<h3>Derived from</h3>
QObject
<h3>Class Attributes</h3>
+
<table>
<tr><td>PreferencesKey</td></tr><tr><td>lexerAssociations</td></tr>
</table>
<h3>Class Methods</h3>
+
<table>
<tr><td>None</td></tr>
</table>
<h3>Methods</h3>
+
<table>
+
<tr>
<td><a href="#ProjectDjangoPlugin.__init__">ProjectDjangoPlugin</a></td>
<td>Constructor</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.__initialize">__initialize</a></td>
<td>Private slot to (re)initialize the plugin.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.__loadTranslator">__loadTranslator</a></td>
<td>Private method to load the translation file.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.__projectClosed">__projectClosed</a></td>
<td>Private slot to handle the projectClosed signal.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.__projectOpened">__projectOpened</a></td>
<td>Private slot to handle the projectOpened signal.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.__reregisterProjectType">__reregisterProjectType</a></td>
<td>Private method to re-register the project type.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.activate">activate</a></td>
<td>Public method to activate this plugin.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.binaryTranslationsCallback">binaryTranslationsCallback</a></td>
<td>Public method to determine the filename of a compiled translation file given the translation source file.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.deactivate">deactivate</a></td>
<td>Public method to deactivate this plugin.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.fileTypesCallback">fileTypesCallback</a></td>
<td>Public method get the filetype associations of the Django project type.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.getMenu">getMenu</a></td>
<td>Public method to get a reference to the requested menu.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.getMenuNames">getMenuNames</a></td>
<td>Public method to get the names of all menus.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.getPreferences">getPreferences</a></td>
<td>Public method to retrieve the various settings.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.lexerAssociationCallback">lexerAssociationCallback</a></td>
<td>Public method to get the lexer association of the Django project type for a file.</td>
-</tr><tr>
+</tr>
+<tr>
<td><a href="#ProjectDjangoPlugin.setPreferences">setPreferences</a></td>
<td>Public method to store the various settings.</td>
</tr>
</table>
<h3>Static Methods</h3>
+
<table>
<tr><td>None</td></tr>
</table>
+
<a NAME="ProjectDjangoPlugin.__init__" ID="ProjectDjangoPlugin.__init__"></a>
<h4>ProjectDjangoPlugin (Constructor)</h4>
<b>ProjectDjangoPlugin</b>(<i>ui</i>)
+
<p>
Constructor
-</p><dl>
+</p>
+<dl>
+
<dt><i>ui</i></dt>
<dd>
reference to the user interface object (UI.UserInterface)
</dd>
-</dl><a NAME="ProjectDjangoPlugin.__initialize" ID="ProjectDjangoPlugin.__initialize"></a>
+</dl>
+<a NAME="ProjectDjangoPlugin.__initialize" ID="ProjectDjangoPlugin.__initialize"></a>
<h4>ProjectDjangoPlugin.__initialize</h4>
<b>__initialize</b>(<i></i>)
+
<p>
Private slot to (re)initialize the plugin.
-</p><a NAME="ProjectDjangoPlugin.__loadTranslator" ID="ProjectDjangoPlugin.__loadTranslator"></a>
+</p>
+<a NAME="ProjectDjangoPlugin.__loadTranslator" ID="ProjectDjangoPlugin.__loadTranslator"></a>
<h4>ProjectDjangoPlugin.__loadTranslator</h4>
<b>__loadTranslator</b>(<i></i>)
+
<p>
Private method to load the translation file.
-</p><a NAME="ProjectDjangoPlugin.__projectClosed" ID="ProjectDjangoPlugin.__projectClosed"></a>
+</p>
+<a NAME="ProjectDjangoPlugin.__projectClosed" ID="ProjectDjangoPlugin.__projectClosed"></a>
<h4>ProjectDjangoPlugin.__projectClosed</h4>
<b>__projectClosed</b>(<i></i>)
+
<p>
Private slot to handle the projectClosed signal.
-</p><a NAME="ProjectDjangoPlugin.__projectOpened" ID="ProjectDjangoPlugin.__projectOpened"></a>
+</p>
+<a NAME="ProjectDjangoPlugin.__projectOpened" ID="ProjectDjangoPlugin.__projectOpened"></a>
<h4>ProjectDjangoPlugin.__projectOpened</h4>
<b>__projectOpened</b>(<i></i>)
+
<p>
Private slot to handle the projectOpened signal.
-</p><a NAME="ProjectDjangoPlugin.__reregisterProjectType" ID="ProjectDjangoPlugin.__reregisterProjectType"></a>
+</p>
+<a NAME="ProjectDjangoPlugin.__reregisterProjectType" ID="ProjectDjangoPlugin.__reregisterProjectType"></a>
<h4>ProjectDjangoPlugin.__reregisterProjectType</h4>
<b>__reregisterProjectType</b>(<i></i>)
+
<p>
Private method to re-register the project type.
-</p><a NAME="ProjectDjangoPlugin.activate" ID="ProjectDjangoPlugin.activate"></a>
+</p>
+<a NAME="ProjectDjangoPlugin.activate" ID="ProjectDjangoPlugin.activate"></a>
<h4>ProjectDjangoPlugin.activate</h4>
<b>activate</b>(<i></i>)
+
<p>
Public method to activate this plugin.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
tuple of None and activation status (boolean)
</dd>
-</dl><a NAME="ProjectDjangoPlugin.binaryTranslationsCallback" ID="ProjectDjangoPlugin.binaryTranslationsCallback"></a>
+</dl>
+<a NAME="ProjectDjangoPlugin.binaryTranslationsCallback" ID="ProjectDjangoPlugin.binaryTranslationsCallback"></a>
<h4>ProjectDjangoPlugin.binaryTranslationsCallback</h4>
<b>binaryTranslationsCallback</b>(<i>filename</i>)
+
<p>
Public method to determine the filename of a compiled translation file
given the translation source file.
-</p><dl>
+</p>
+<dl>
+
<dt><i>filename</i></dt>
<dd>
name of the translation source file (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
name of the binary translation file (string)
</dd>
-</dl><a NAME="ProjectDjangoPlugin.deactivate" ID="ProjectDjangoPlugin.deactivate"></a>
+</dl>
+<a NAME="ProjectDjangoPlugin.deactivate" ID="ProjectDjangoPlugin.deactivate"></a>
<h4>ProjectDjangoPlugin.deactivate</h4>
<b>deactivate</b>(<i></i>)
+
<p>
Public method to deactivate this plugin.
-</p><a NAME="ProjectDjangoPlugin.fileTypesCallback" ID="ProjectDjangoPlugin.fileTypesCallback"></a>
+</p>
+<a NAME="ProjectDjangoPlugin.fileTypesCallback" ID="ProjectDjangoPlugin.fileTypesCallback"></a>
<h4>ProjectDjangoPlugin.fileTypesCallback</h4>
<b>fileTypesCallback</b>(<i></i>)
+
<p>
Public method get the filetype associations of the Django project type.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
dictionary with file type associations
</dd>
-</dl><a NAME="ProjectDjangoPlugin.getMenu" ID="ProjectDjangoPlugin.getMenu"></a>
+</dl>
+<a NAME="ProjectDjangoPlugin.getMenu" ID="ProjectDjangoPlugin.getMenu"></a>
<h4>ProjectDjangoPlugin.getMenu</h4>
<b>getMenu</b>(<i>name</i>)
+
<p>
Public method to get a reference to the requested menu.
-</p><dl>
+</p>
+<dl>
+
<dt><i>name</i></dt>
<dd>
name of the menu (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
reference to the menu (QMenu) or None, if no
menu with the given name exists
</dd>
-</dl><a NAME="ProjectDjangoPlugin.getMenuNames" ID="ProjectDjangoPlugin.getMenuNames"></a>
+</dl>
+<a NAME="ProjectDjangoPlugin.getMenuNames" ID="ProjectDjangoPlugin.getMenuNames"></a>
<h4>ProjectDjangoPlugin.getMenuNames</h4>
<b>getMenuNames</b>(<i></i>)
+
<p>
Public method to get the names of all menus.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
menu names (list of string)
</dd>
-</dl><a NAME="ProjectDjangoPlugin.getPreferences" ID="ProjectDjangoPlugin.getPreferences"></a>
+</dl>
+<a NAME="ProjectDjangoPlugin.getPreferences" ID="ProjectDjangoPlugin.getPreferences"></a>
<h4>ProjectDjangoPlugin.getPreferences</h4>
<b>getPreferences</b>(<i>key</i>)
+
<p>
Public method to retrieve the various settings.
-</p><dl>
+</p>
+<dl>
+
<dt><i>key</i></dt>
<dd>
the key of the value to get
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
the requested setting
</dd>
-</dl><a NAME="ProjectDjangoPlugin.lexerAssociationCallback" ID="ProjectDjangoPlugin.lexerAssociationCallback"></a>
+</dl>
+<a NAME="ProjectDjangoPlugin.lexerAssociationCallback" ID="ProjectDjangoPlugin.lexerAssociationCallback"></a>
<h4>ProjectDjangoPlugin.lexerAssociationCallback</h4>
<b>lexerAssociationCallback</b>(<i>filename</i>)
+
<p>
Public method to get the lexer association of the Django project type
for a file.
-</p><dl>
+</p>
+<dl>
+
<dt><i>filename</i></dt>
<dd>
name of the file (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
name of the lexer (string) (Pygments lexers are prefixed with
'Pygments|')
</dd>
-</dl><a NAME="ProjectDjangoPlugin.setPreferences" ID="ProjectDjangoPlugin.setPreferences"></a>
+</dl>
+<a NAME="ProjectDjangoPlugin.setPreferences" ID="ProjectDjangoPlugin.setPreferences"></a>
<h4>ProjectDjangoPlugin.setPreferences</h4>
<b>setPreferences</b>(<i>key, value</i>)
+
<p>
Public method to store the various settings.
-</p><dl>
+</p>
+<dl>
+
<dt><i>key</i></dt>
<dd>
the key of the setting to be set (string)
-</dd><dt><i>value</i></dt>
+</dd>
+<dt><i>value</i></dt>
<dd>
the value to be set
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
<a NAME="apiFiles" ID="apiFiles"></a>
<h2>apiFiles</h2>
<b>apiFiles</b>(<i>language</i>)
+
<p>
Module function to return the API files made available by this plugin.
-</p><dl>
+</p>
+<dl>
+
<dt><i>language</i></dt>
<dd>
language to get APIs for (string)
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
list of API filenames (list of string)
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
<a NAME="createDjangoPage" ID="createDjangoPage"></a>
<h2>createDjangoPage</h2>
<b>createDjangoPage</b>(<i>configDlg</i>)
+
<p>
Module function to create the Django configuration page.
-</p><dl>
+</p>
+<dl>
+
<dt><i>configDlg</i></dt>
<dd>
reference to the configuration dialog
</dd>
-</dl><dl>
+</dl>
+<dl>
<dt>Returns:</dt>
<dd>
reference to the configuration page
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
<a NAME="getConfigData" ID="getConfigData"></a>
<h2>getConfigData</h2>
<b>getConfigData</b>(<i></i>)
+
<p>
Module function returning data as required by the configuration dialog.
-</p><dl>
+</p>
+<dl>
<dt>Returns:</dt>
<dd>
dictionary containing the relevant data
</dd>
</dl>
<div align="right"><a href="#top">Up</a></div>
-<hr /><hr />
+<hr />
+<hr />
<a NAME="prepareUninstall" ID="prepareUninstall"></a>
<h2>prepareUninstall</h2>
<b>prepareUninstall</b>(<i></i>)
+
<p>
Module function to prepare for an uninstallation.
</p>
