mariano/soleprint
Public Access
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Improve soleprint docs: bilingual EN/ES, system pages, architecture cleanup

Browse Source
This commit is contained in:
buenosairesam
2026-01-27 09:15:59 -03:00
parent ed1c8f6c96
commit fa7bbe3953
6 changed files with 1366 additions and 51 deletions
Download Patch File Download Diff File Expand all files Collapse all files

258
docs/atlas/index.html Normal file
View File

@@ -0,0 +1,258 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Atlas - Soleprint</title>
<link rel="stylesheet" href="../architecture/styles.css" />
<style>
.composition {
background: #1a1a1a;
border: 2px solid #15803d;
padding: 1rem;
border-radius: 12px;
margin-bottom: 1rem;
}
.composition h3 {
margin: 0 0 0.75rem 0;
font-size: 1.1rem;
color: #86efac;
}
.composition > p {
margin: 0 0 1rem 0;
font-size: 0.9rem;
color: #a3a3a3;
}
.components {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
gap: 0.75rem;
}
.component {
background: #0a0a0a;
border: 1px solid #3f3f3f;
padding: 0.75rem;
border-radius: 8px;
}
.component h4 {
margin: 0 0 0.25rem 0;
font-size: 0.95rem;
color: #86efac;
}
.component p {
margin: 0;
font-size: 0.85rem;
color: #a3a3a3;
}
.model-grid {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
gap: 1rem;
}
</style>
<script src="../lang-toggle.js"></script>
</head>
<body>
<header>
<div id="lang-toggle"></div>
<h1>Atlas</h1>
<p class="subtitle">Todo lo escrito</p>
</header>
<main>
<section class="findings-section">
<h2>
<span class="lang-en">Model</span
><span class="lang-es">Modelo</span>
</h2>
<div class="model-grid">
<div class="composition">
<h3>Plain Book</h3>
<p class="lang-en">
Static documentation with an index page
</p>
<p class="lang-es">
Documentacion estatica con una pagina indice
</p>
<div class="components">
<div class="component">
<h4>index.html</h4>
<p class="lang-en">Entry point</p>
<p class="lang-es">Punto de entrada</p>
</div>
<div class="component">
<h4>Depot</h4>
<p class="lang-en">Static content</p>
<p class="lang-es">Contenido estatico</p>
</div>
</div>
</div>
<div class="composition">
<h3>Templated Book</h3>
<p class="lang-en">
Dynamic docs from template + data elements
</p>
<p class="lang-es">
Docs dinamicos desde template + elementos de datos
</p>
<div class="components">
<div class="component">
<h4>Template</h4>
<p class="lang-en">Jinja2 pattern</p>
<p class="lang-es">Patron Jinja2</p>
</div>
<div class="component">
<h4>Depot</h4>
<p class="lang-en">Data elements</p>
<p class="lang-es">Elementos de datos</p>
</div>
</div>
</div>
</div>
</section>
<section class="findings-section">
<h2>
<span class="lang-en">Architecture</span
><span class="lang-es">Arquitectura</span>
</h2>
<img
src="../architecture/01-system-overview.svg"
alt="System Overview"
style="
max-width: 100%;
background: white;
border-radius: 8px;
padding: 1rem;
"
/>
</section>
<section class="findings-section">
<h2>
<span class="lang-en">Components</span
><span class="lang-es">Componentes</span>
</h2>
<div class="findings-grid">
<article class="finding-card">
<h3>Book</h3>
<p class="lang-en">
Collection of related documentation. Can be plain
(static HTML) or templated (template + depot
elements).
</p>
<p class="lang-es">
Coleccion de documentacion relacionada. Puede ser
plain (HTML estatico) o templated (template +
elementos de depot).
</p>
</article>
<article class="finding-card">
<h3>Template</h3>
<p class="lang-en">
Jinja2 templates that generate documentation. Define
the structure once, fill with data from depot.
</p>
<p class="lang-es">
Templates Jinja2 que generan documentacion. Definen
la estructura una vez, llenan con datos del depot.
</p>
</article>
</div>
</section>
<section class="findings-section">
<h2>
<span class="lang-en">Shared Components</span
><span class="lang-es">Componentes Compartidos</span>
</h2>
<div class="findings-grid">
<article class="finding-card">
<h3>Room</h3>
<p class="lang-en">
Runtime environment configuration. Each room can
have its own atlas with project-specific books.
</p>
<p class="lang-es">
Configuracion del entorno. Cada room puede tener su
propio atlas con books especificos del proyecto.
</p>
</article>
<article class="finding-card">
<h3>Depot</h3>
<p class="lang-en">
Data storage. For plain books: static files. For
templated books: elements that fill the template.
</p>
<p class="lang-es">
Almacenamiento de datos. Para plain books: archivos
estaticos. Para templated books: elementos que
llenan el template.
</p>
</article>
</div>
</section>
<section class="findings-section">
<h2>
<span class="lang-en">Examples</span
><span class="lang-es">Ejemplos</span>
</h2>
<div class="findings-grid">
<article class="finding-card">
<h3>Feature Flow</h3>
<p class="lang-en">
Plain book - HTML presentation explaining the
standardization pipeline.
</p>
<p class="lang-es">
Plain book - Presentacion HTML explicando el
pipeline de estandarizacion.
</p>
</article>
<article class="finding-card">
<h3>Feature Form Samples</h3>
<p class="lang-en">
Templated book - Form template + depot of actual
feature forms.
</p>
<p class="lang-es">
Templated book - Template de formulario + depot de
feature forms reales.
</p>
</article>
<article class="finding-card">
<h3>Gherkin Samples</h3>
<p class="lang-en">
Templated book - Gherkin viewer + depot of .feature
files.
</p>
<p class="lang-es">
Templated book - Visor Gherkin + depot de archivos
.feature.
</p>
</article>
<article class="finding-card">
<h3>Arch Model</h3>
<p class="lang-en">
Plain book - Static site with architecture diagrams.
</p>
<p class="lang-es">
Plain book - Sitio estatico con diagramas de
arquitectura.
</p>
</article>
</div>
</section>
</main>
<footer>
<p>
<a href="../"
><span class="lang-en">← Back to index</span
><span class="lang-es">← Volver al indice</span></a
>
</p>
</footer>
</body>
</html>