Deployed 49935a7306 to master with MkDocs 1.2.1 and mike 1.0.1

master/extensions/guides/main-extension/index.html

@@ -518,11 +518,11 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#lensmainextension-class" class="md-nav__link">
-    LensMainExtension Class
+  <a href="#mainlensextension-class" class="md-nav__link">
+    Main.LensExtension Class
   </a>
   
-    <nav class="md-nav" aria-label="LensMainExtension Class">
+    <nav class="md-nav" aria-label="Main.LensExtension Class">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
@@ -537,6 +537,13 @@
     appMenus
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#addcatalogsource-and-removecatalogsource-methods" class="md-nav__link">
+    addCatalogSource() and removeCatalogSource() Methods
+  </a>
+  
 </li>
         
       </ul>
@@ -572,6 +579,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../catalog/" class="md-nav__link">
+        Catalog
+      </a>
+    </li>
+  
+
+            
+          
+            
+              
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../resource-stack/" class="md-nav__link">
+        Resource Stack
+      </a>
+    </li>
+  
+
+            
+          
+            
+              
+  
+  
+  
     <li class="md-nav__item">
       <a href="../stores/" class="md-nav__link">
         Stores
@@ -732,11 +767,11 @@
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
         <li class="md-nav__item">
-  <a href="#lensmainextension-class" class="md-nav__link">
-    LensMainExtension Class
+  <a href="#mainlensextension-class" class="md-nav__link">
+    Main.LensExtension Class
   </a>
   
-    <nav class="md-nav" aria-label="LensMainExtension Class">
+    <nav class="md-nav" aria-label="Main.LensExtension Class">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
@@ -751,6 +786,13 @@
     appMenus
   </a>
   
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#addcatalogsource-and-removecatalogsource-methods" class="md-nav__link">
+    addCatalogSource() and removeCatalogSource() Methods
+  </a>
+  
 </li>
         
       </ul>
@@ -775,10 +817,11 @@
                 <h1 id="main-extension">Main Extension<a class="headerlink" href="#main-extension" title="Permanent link">#</a></h1>
 <p>The Main Extension API is the interface to Lens's main process.
 Lens runs in both main and renderer processes.
-The Main Extension API allows you to access, configure, and customize Lens data, add custom application menu items, and run custom code in Lens's main process.</p>
-<h2 id="lensmainextension-class"><code>LensMainExtension</code> Class<a class="headerlink" href="#lensmainextension-class" title="Permanent link">#</a></h2>
+The Main Extension API allows you to access, configure, and customize Lens data, add custom application menu items and <a href="../protocol-handlers/">protocol handlers</a>, and run custom code in Lens's main process.
+It also provides convenient methods for navigating to built-in Lens pages and extension pages, as well as adding and removing sources of catalog entities. </p>
+<h2 id="mainlensextension-class"><code>Main.LensExtension</code> Class<a class="headerlink" href="#mainlensextension-class" title="Permanent link">#</a></h2>
 <h3 id="onactivate-and-ondeactivate-methods"><code>onActivate()</code> and <code>onDeactivate()</code> Methods<a class="headerlink" href="#onactivate-and-ondeactivate-methods" title="Permanent link">#</a></h3>
-<p>To create a main extension simply extend the <code>LensMainExtension</code> class:</p>
+<p>To create a main extension simply extend the <code>Main.LensExtension</code> class:</p>
 <div class="highlight"><pre><span></span><code><span class="k">import</span> <span class="p">{</span> <span class="nx">Main</span> <span class="p">}</span> <span class="k">from</span> <span class="s2">&quot;@k8slens/extensions&quot;</span><span class="p">;</span>
 
 <span class="k">export</span> <span class="k">default</span> <span class="kd">class</span> <span class="nx">ExampleExtensionMain</span> <span class="k">extends</span> <span class="nx">Main</span><span class="p">.</span><span class="nx">LensExtension</span> <span class="p">{</span>
@@ -836,6 +879,24 @@ In this example, we simply log a message.
 However, you would typically have this navigate to a specific page or perform another operation.
 Note that pages are associated with the <a href="../renderer-extension/"><code>Renderer.LensExtension</code></a> class and can be defined in the process of extending it.</li>
 </ul>
+<p>The following example demonstrates how an application menu can be used to navigate to such a page:</p>
+<div class="highlight"><pre><span></span><code><span class="k">import</span> <span class="p">{</span> <span class="nx">Main</span> <span class="p">}</span> <span class="k">from</span> <span class="s2">&quot;@k8slens/extensions&quot;</span><span class="p">;</span>
+
+<span class="k">export</span> <span class="k">default</span> <span class="kd">class</span> <span class="nx">SamplePageMainExtension</span> <span class="k">extends</span> <span class="nx">Main</span><span class="p">.</span><span class="nx">LensExtension</span> <span class="p">{</span>
+  <span class="nx">appMenus</span> <span class="o">=</span> <span class="p">[</span>
+    <span class="p">{</span>
+      <span class="nx">parentId</span><span class="o">:</span> <span class="s2">&quot;help&quot;</span><span class="p">,</span>
+      <span class="nx">label</span><span class="o">:</span> <span class="s2">&quot;Sample&quot;</span><span class="p">,</span>
+      <span class="nx">click</span><span class="o">:</span> <span class="p">()</span> <span class="o">=&gt;</span> <span class="k">this</span><span class="p">.</span><span class="nx">navigate</span><span class="p">(</span><span class="s2">&quot;myGlobalPage&quot;</span><span class="p">)</span>
+    <span class="p">}</span>
+  <span class="p">]</span>
+<span class="p">}</span>
+</code></pre></div>
+<p>When the menu item is clicked the <code>navigate()</code> method looks for and displays a global page with id <code>"myGlobalPage"</code>.
+This page would be defined in your extension's <code>Renderer.LensExtension</code> implmentation (See <a href="../renderer-extension/"><code>Renderer.LensExtension</code></a>).</p>
+<h3 id="addcatalogsource-and-removecatalogsource-methods"><code>addCatalogSource()</code> and <code>removeCatalogSource()</code> Methods<a class="headerlink" href="#addcatalogsource-and-removecatalogsource-methods" title="Permanent link">#</a></h3>
+<p>The <code>Main.LensExtension</code> class also provides the <code>addCatalogSource()</code> and <code>removeCatalogSource()</code> methods, for managing custom catalog items (or entities).
+See the <a href="../catalog/"><code>Catalog</code></a> documentation for full details about the catalog.</p>