rhtyd commented on a change in pull request #199:
URL: 
https://github.com/apache/cloudstack-documentation/pull/199#discussion_r605442692



##########
File path: source/adminguide/ui.rst
##########
@@ -273,6 +280,47 @@ Some assorted primary theme colours:
 - Green: #52C41A
 - Purple: #722ED1
 
+Contextual help documentation URLs can be customized with the help of 
`docBase` and `docHelpMappings` properties.
+A list of documentation help suffixes in code can be obtained using following 
command:
+
+.. parsed-literal::
+
+   grep -rnw cloudstack/ui/src/config/section -e 'docHelp:'
+
+Below example shows configuration changes for custom documentation help URLs:
+
+.. parsed-literal::
+
+   {
+      ...
+      "docBase": http://mycustomwebsite.com,
+      ...
+      "docHelpMappings": {
+         "adminguide/virtual_machines.html": "custom_vm_page.html",
+         "adminguide/templates.html": "custom_templates_page.html"
+      },
+      ...
+   }
+
+UI also provides option to show custom plugins by displaying a custom HTML 
page or service in an iframe. Such plugins can be listed in the config file 
using `plugins` property.
+Example for adding a custom plugin:
+
+.. parsed-literal::
+
+   {
+      ...
+      plugins: [
+         {
+            "name": "ExamplePlugin",
+            "icon": "appstore",
+            "path": "example.html"

Review comment:
       @shwstppr can you add another example, where the path is an external 
URL; for example:
   ```
     "plugins": [{
       "name": "External Link Example",
       "icon": "hdd",
       "path": "http://192.168.1.10:7000";
     }]
   
   ```

##########
File path: source/adminguide/ui.rst
##########
@@ -273,6 +280,47 @@ Some assorted primary theme colours:
 - Green: #52C41A
 - Purple: #722ED1
 
+Contextual help documentation URLs can be customized with the help of 
`docBase` and `docHelpMappings` properties.
+A list of documentation help suffixes in code can be obtained using following 
command:
+
+.. parsed-literal::
+
+   grep -rnw cloudstack/ui/src/config/section -e 'docHelp:'
+
+Below example shows configuration changes for custom documentation help URLs:
+
+.. parsed-literal::
+
+   {
+      ...
+      "docBase": http://mycustomwebsite.com,
+      ...
+      "docHelpMappings": {
+         "adminguide/virtual_machines.html": "custom_vm_page.html",
+         "adminguide/templates.html": "custom_templates_page.html"
+      },
+      ...
+   }
+
+UI also provides option to show custom plugins by displaying a custom HTML 
page or service in an iframe. Such plugins can be listed in the config file 
using `plugins` property.
+Example for adding a custom plugin:
+
+.. parsed-literal::
+
+   {
+      ...
+      plugins: [
+         {
+            "name": "ExamplePlugin",
+            "icon": "appstore",
+            "path": "example.html"

Review comment:
       @shwstppr can you add another example, where the path is an external 
URL; for example:
   ```
     "plugins": [{
       "name": "External Link Example",
       "icon": "hdd",
       "path": "http://example.com/portal";
     }]
   
   ```




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


Reply via email to