This commit is contained in:
@@ -748,6 +748,15 @@
|
||||
<nav class="md-nav" aria-label="base">
|
||||
<ul class="md-nav__list">
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.base--summary" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Summary
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.base-classes" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
@@ -1096,6 +1105,15 @@
|
||||
<nav class="md-nav" aria-label="base">
|
||||
<ul class="md-nav__list">
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.base--summary" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Summary
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.base-classes" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
@@ -1210,7 +1228,8 @@
|
||||
|
||||
<div class="doc doc-contents first">
|
||||
|
||||
<p>Renderer base interfaces and configuration models.</p>
|
||||
<h3 id="docforge.renderers.base--summary">Summary</h3>
|
||||
<p>Renderer base interfaces and configuration models.</p>
|
||||
<p>This module defines the base protocol and configuration container used by
|
||||
doc-forge renderers. Concrete renderer implementations should implement the
|
||||
<code>DocRenderer</code> protocol.</p>
|
||||
@@ -1307,8 +1326,7 @@ doc-forge renderers. Concrete renderer implementations should implement the
|
||||
</td>
|
||||
<td>
|
||||
<div class="doc-md-description">
|
||||
<p>Directory where generated documentation sources
|
||||
should be written.</p>
|
||||
<p>Directory where generated documentation sources should be written.</p>
|
||||
</div>
|
||||
</td>
|
||||
<td>
|
||||
|
||||
@@ -961,6 +961,15 @@
|
||||
<nav class="md-nav" aria-label="renderers">
|
||||
<ul class="md-nav__list">
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers--summary" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Summary
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers--overview" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
@@ -1117,11 +1126,12 @@
|
||||
|
||||
<div class="doc doc-contents first">
|
||||
|
||||
<p>Renderers layer for doc-forge.</p>
|
||||
<h3 id="docforge.renderers--summary">Summary</h3>
|
||||
<p>Renderers layer for doc-forge.</p>
|
||||
<p>The <code>docforge.renderers</code> package transforms the internal documentation
|
||||
models into files formatted for specific documentation systems.</p>
|
||||
<hr />
|
||||
<h4 id="docforge.renderers--overview">Overview</h4>
|
||||
<h3 id="docforge.renderers--overview">Overview</h3>
|
||||
<p>Renderers consume the doc-forge project model and generate output suitable
|
||||
for documentation tools or machine interfaces.</p>
|
||||
<p>Current implementations:</p>
|
||||
@@ -1133,7 +1143,7 @@ for documentation tools or machine interfaces.</p>
|
||||
by Model Context Protocol (MCP) clients.</li>
|
||||
</ul>
|
||||
<hr />
|
||||
<h4 id="docforge.renderers--extending">Extending</h4>
|
||||
<h3 id="docforge.renderers--extending">Extending</h3>
|
||||
<p>New renderers can be added by implementing the <code>DocRenderer</code> protocol
|
||||
defined in <code>docforge.renderers.base</code>.</p>
|
||||
<hr />
|
||||
@@ -1300,8 +1310,8 @@ allowing MkDocs to render API documentation dynamically.</p>
|
||||
<p>Generate a <code>README.md</code> file from the root module docstring.</p>
|
||||
<p>Behavior:</p>
|
||||
<ul>
|
||||
<li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the
|
||||
project root directory.</li>
|
||||
<li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the project
|
||||
root directory.</li>
|
||||
<li>If False, README generation is currently not implemented.</li>
|
||||
</ul>
|
||||
|
||||
@@ -1348,12 +1358,11 @@ allowing MkDocs to render API documentation dynamically.</p>
|
||||
<tr class="doc-section-item">
|
||||
<td><code>module_is_source</code></td>
|
||||
<td>
|
||||
<code>bool | None</code>
|
||||
<code>bool</code>
|
||||
</td>
|
||||
<td>
|
||||
<div class="doc-md-description">
|
||||
<p>Whether the module is treated as the project
|
||||
source root.</p>
|
||||
<p>Whether the module is treated as the project source root.</p>
|
||||
</div>
|
||||
</td>
|
||||
<td>
|
||||
@@ -1428,12 +1437,12 @@ specified output directory.</p>
|
||||
<tr class="doc-section-item">
|
||||
<td><code>module_is_source</code></td>
|
||||
<td>
|
||||
<code>bool | None</code>
|
||||
<code>bool</code>
|
||||
</td>
|
||||
<td>
|
||||
<div class="doc-md-description">
|
||||
<p>If True, treat the specified module as the
|
||||
documentation root rather than nesting it inside a folder.</p>
|
||||
<p>If True, treat the specified module as the documentation root
|
||||
rather than nesting it inside a folder.</p>
|
||||
</div>
|
||||
</td>
|
||||
<td>
|
||||
|
||||
@@ -794,6 +794,15 @@
|
||||
<nav class="md-nav" aria-label="mcp_renderer">
|
||||
<ul class="md-nav__list">
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.mcp_renderer--summary" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Summary
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.mcp_renderer-classes" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
@@ -1072,6 +1081,15 @@
|
||||
<nav class="md-nav" aria-label="mcp_renderer">
|
||||
<ul class="md-nav__list">
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.mcp_renderer--summary" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Summary
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.mcp_renderer-classes" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
@@ -1162,6 +1180,11 @@
|
||||
|
||||
<div class="doc doc-contents first">
|
||||
|
||||
<h3 id="docforge.renderers.mcp_renderer--summary">Summary</h3>
|
||||
<p>MCP renderer implementation.</p>
|
||||
<p>This module defines the <code>MCPRenderer</code> class, which generates documentation
|
||||
resources compatible with the Model Context Protocol (MCP).</p>
|
||||
|
||||
|
||||
|
||||
<div class="doc doc-children">
|
||||
|
||||
@@ -771,6 +771,15 @@
|
||||
<nav class="md-nav" aria-label="mkdocs_renderer">
|
||||
<ul class="md-nav__list">
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.mkdocs_renderer--summary" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Summary
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.mkdocs_renderer-classes" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
@@ -1081,6 +1090,15 @@
|
||||
<nav class="md-nav" aria-label="mkdocs_renderer">
|
||||
<ul class="md-nav__list">
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.mkdocs_renderer--summary" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
Summary
|
||||
</span>
|
||||
</a>
|
||||
|
||||
</li>
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="#docforge.renderers.mkdocs_renderer-classes" class="md-nav__link">
|
||||
<span class="md-ellipsis">
|
||||
@@ -1180,7 +1198,8 @@
|
||||
|
||||
<div class="doc doc-contents first">
|
||||
|
||||
<p>MkDocs renderer implementation.</p>
|
||||
<h3 id="docforge.renderers.mkdocs_renderer--summary">Summary</h3>
|
||||
<p>MkDocs renderer implementation.</p>
|
||||
<p>This module defines the <code>MkDocsRenderer</code> class, which generates Markdown
|
||||
documentation sources compatible with MkDocs Material and the mkdocstrings
|
||||
plugin.</p>
|
||||
@@ -1250,8 +1269,8 @@ allowing MkDocs to render API documentation dynamically.</p>
|
||||
<p>Generate a <code>README.md</code> file from the root module docstring.</p>
|
||||
<p>Behavior:</p>
|
||||
<ul>
|
||||
<li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the
|
||||
project root directory.</li>
|
||||
<li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the project
|
||||
root directory.</li>
|
||||
<li>If False, README generation is currently not implemented.</li>
|
||||
</ul>
|
||||
|
||||
@@ -1298,12 +1317,11 @@ allowing MkDocs to render API documentation dynamically.</p>
|
||||
<tr class="doc-section-item">
|
||||
<td><code>module_is_source</code></td>
|
||||
<td>
|
||||
<code>bool | None</code>
|
||||
<code>bool</code>
|
||||
</td>
|
||||
<td>
|
||||
<div class="doc-md-description">
|
||||
<p>Whether the module is treated as the project
|
||||
source root.</p>
|
||||
<p>Whether the module is treated as the project source root.</p>
|
||||
</div>
|
||||
</td>
|
||||
<td>
|
||||
@@ -1378,12 +1396,12 @@ specified output directory.</p>
|
||||
<tr class="doc-section-item">
|
||||
<td><code>module_is_source</code></td>
|
||||
<td>
|
||||
<code>bool | None</code>
|
||||
<code>bool</code>
|
||||
</td>
|
||||
<td>
|
||||
<div class="doc-md-description">
|
||||
<p>If True, treat the specified module as the
|
||||
documentation root rather than nesting it inside a folder.</p>
|
||||
<p>If True, treat the specified module as the documentation root
|
||||
rather than nesting it inside a folder.</p>
|
||||
</div>
|
||||
</td>
|
||||
<td>
|
||||
|
||||
Reference in New Issue
Block a user