_es/2023-09-19-maquetado.markdown

@@ -28,7 +28,7 @@ render_with_liquid: false
 usuaries:
 - 534
 created_at: 2023-09-19 16:35:07.189092105 +00:00
-last_modified_at: 2024-10-11 00:36:42.585868975 +00:00
+last_modified_at: 2024-10-11 19:49:32.720860398 +00:00
 ---
 
 <p style="text-align:start"></p>
\ No newline at end of file

_es/2024-01-04-crear-sitio-nuevo.markdown

@@ -20,39 +20,100 @@ usuaries:
 - 224
 - 534
 created_at: 2024-01-04 18:52:27.094865811 +00:00
-last_modified_at: 2024-10-11 00:36:42.550508751 +00:00
+last_modified_at: 2024-10-11 19:49:32.686937129 +00:00
 ---
 
-<p style="text-align:start">Primero que nada, si lo que querés es crear un sitio de testing <strong>de una plantilla</strong>, no hace falta hacer esto, alcanza con crear un sitio desde el panel con ".testing" en el nombre</p>
+<h2 style="text-align:start" id="clonar-repositorio">Clonar repositorio</h2>
+<p style="text-align:start">Hay dos maneras de clonar un repositorio desde sutty-base:</p>
+<h3 style="text-align:start" id="1.-forkear-repo-desde-0xacab">1. Forkear repo desde 0xacab</h3>
+<p style="text-align:start">En el repositorio de sutty-base de 0xacab usar la opción de Fork</p>
+<figure><img src="public/33cd31e13a6098xi0mssi82e6bwg/Captura de pantalla_20241011_160615.png" class="img-fluid" controls="false"></figure>
+<figure><img src="public/68v8ykiqprut2bte1f828bajvpqd/Captura de pantalla_20241011_161126.png" class="img-fluid" controls="false"></figure>
 <p style="text-align:start"></p>
-<p style="text-align:start"># crear un sitio desde sutty-base</p>
-<p style="text-align:start">## local y pushear a 0xacab</p>
-<p style="text-align:start">### clonar repositorio</p>
-<p style="text-align:start">1. `git clone git@0xacab.org:sutty/jekyll/sutty-base-jekyll-theme.git` $nombredesitio-jekyll-theme</p>
-<p style="text-align:start">2. `cd $nombredesitio-jekyll-them`</p>
-<p style="text-align:start">### cambiar el origen y sumar upstream</p>
-<p style="text-align:start">3. `git remote set-url origin git@0xacab.org:sutty/jekyll/$nombredelsitio-jekyll-theme.git`</p>
-<p style="text-align:start">`git remote add upstream git@0xacab.org:sutty/jekyll/sutty-base-jekyll-theme.git`</p>
+<h3 style="text-align:start" id="2.-clonar-desde-linea-de-comandos">2. Clonar desde línea de comandos</h3>
+<p style="text-align:start">En la terminal escribir:</p>
+<p style="text-align:start"><code>git clone git@0xacab.org:sutty/jekyll/sutty-base-jekyll-theme.git $nombredesitio-jekyll-theme</code></p>
+<p style="text-align:start"><code>cd $nombredesitio-jekyll-them</code></p>
 <p style="text-align:start"></p>
-<p style="text-align:start">configurar upstream unicamente para traer cambios</p>
-<p style="text-align:start">` git remote set-url --push upstream ""`</p>
-<p style="text-align:start">### traer archivos e indice de lfs y pushearlo al origen master nuevo</p>
-<p style="text-align:start">4. `git lfs fetch upstream --all`</p>
-<p style="text-align:start">5. `git lfs push origin master --all`</p>
-<p style="text-align:start">6. `git push origin master`</p>
-<p style="text-align:start">### compilar sitio localmente y pushear actualizacion de gemas</p>
-<p style="text-align:start">7. hacer una compilación del sitio local para generar el Gemfile.lock y pushearlo con `task build` (según la distro, puede ser `go-task build`)</p>
-<p style="text-align:start">## 0xacab dar acceso a escritura y llaves</p>
-<p style="text-align:start">en Settings &gt; Repository del proyecto (p.e. https://0xacab.org/sutty/jekyll/$nombredeproyecto-jekyll-theme/-/settings/repository)</p>
-<p style="text-align:start">activar llaves en `Deploy keys`</p>
-<p style="text-align:start">* ci</p>
-<p style="text-align:start">* sutty</p>
-<p style="text-align:start">![](https://hedgedoc.nulo.ar/uploads/3ad30d15-cd07-4be2-b367-252278117868.png)</p>
-<p style="text-align:start">- dar permisos de escritura</p>
-<p style="text-align:start">- [ ] Grant write permissions to this key</p>
-<p style="text-align:start">## clonar el sitio en gethen</p>
-<p style="text-align:start">en `_sites/` clonar el repositorio con el nombre que va a tener el proyecto al crear el sitio en el panel</p>
-<p style="text-align:start">git clone git@0xacab.org:sutty/jekyll/$nombredesitio-jekyll-theme.git $nombredesitio/</p>
-<p style="text-align:start">## crear el sitio desde el panel</p>
-<p style="text-align:start">ponerle el mismo nombre que la carpeta en gethen y seleccionar sí o sí Mi propio diseño, sino se rompe el panel</p>
+<h2 style="text-align:start" id="cambiar-el-origen-y-sumar-upstream">Cambiar el origen y sumar upstream</h2>
+<p style="text-align:start"><code>git remote set-url origin git@0xacab.org:sutty/jekyll/$nombredelsitio-jekyll-theme.git</code></p>
+<p style="text-align:start"><code>git remote add upstream git@0xacab.org:sutty/jekyll/sutty-base-jekyll-theme.git</code></p>
+<p style="text-align:start"></p>
+<p style="text-align:start">Configurar upstream únicamente para traer cambios:</p>
+<p style="text-align:start"><code>git remote set-url --push upstream ""</code></p>
+<h2 style="text-align:start" id="traer-archivos-e-indice-de-lfs-y-pushearlo-al-origen-master-nuevo">Traer archivos e índice de lfs y pushearlo al origen master nuevo</h2>
+<p style="text-align:start"><code>git lfs fetch upstream --all</code></p>
+<p style="text-align:start"><code>git lfs push origin master --all</code></p>
+<p style="text-align:start"><code>git push origin master</code></p>
+<h2 style="text-align:start" id="compilar-sitio-localmente-y-pushear-actualizacion-de-gemas">Compilar sitio localmente y pushear actualización de gemas</h2>
+<p style="text-align:start">Hacer una compilación del sitio local para generar el Gemfile.lock y pushearlo con <code>task build</code> (según la distro, puede ser <code>go-task build</code>)</p>
+<h2 style="text-align:start" id="dar-acceso-a-escritura-y-llaves">Dar acceso a escritura y llaves</h2>
+<p style="text-align:start">En 0xacab, en Settings &gt; Repository del proyecto (p.e. https://0xacab.org/sutty/jekyll/$nombredeproyecto-jekyll-theme/-/settings/repository)</p>
+<ul>
+  <li>
+    <p style="text-align:start">Activar llaves en <strong>Deploy keys: </strong>sutty</p>
+  </li>
+</ul>
+<figure><img src="public/hlpe6twlv7bm6d4z0u2g0eyw6iv3/Screenshot 2024-10-11 at 16-30-39 Repository · Settings · sutty _ jekyll _ distributed-press-onboarding-jekyll-theme · GitLab.png" class="img-fluid" controls="false"></figure>
+<p style="text-align:start"></p>
+<ul>
+  <li>
+    <p style="text-align:start">Editar la llave y dar permisos de escritura: "Grant write permissions to this key"</p>
+  </li>
+</ul>
+<h2 style="text-align:start" id="clonar-el-sitio-en-gethen">Clonar el sitio en gethen</h2>
+<p style="text-align:start">En `_sites/` clonar el repositorio con el nombre que va a tener el proyecto al crear el sitio en el panel:</p>
+<p style="text-align:start"><code>git clone git@0xacab.org:sutty/jekyll/$nombredesitio-jekyll-theme.git $nombredesitio/</code></p>
+<p style="text-align:start">Hacer lo mismo para el sitio de testing:</p>
+<p style="text-align:start"><code>git clone git@0xacab.org:sutty/jekyll/$nombredesitio.testing-jekyll-theme.git $nombredesitio.testing/</code></p>
+<h2 style="text-align:start" id="crear-el-sitio-desde-el-panel">Crear el sitio desde el panel</h2>
+<p style="text-align:start">Ponerle el mismo nombre que la carpeta en gethen y seleccionar sí o sí "Mi propio diseño", sino se rompe el panel.</p>
+<p style="text-align:start">Hacer lo mismo para el sitio de testing.</p>
+<p style="text-align:start"><strong>Aviso:</strong> Si lo que se quiere es crear un sitio de testing <strong>de una plantilla</strong>, no hace falta hacer esto, alcanza con crear un sitio desde el panel con ".testing" en el nombre.</p>
+<h2 style="text-align:start" id="activar-webhooks">Activar Webhooks</h2>
+<ol>
+  <li>
+    <p style="text-align:start">En el repo del sitio nuevo en 0xacab ir a Settings &gt; Webhooks.</p>
+  </li>
+  <li>
+    <p style="text-align:start">Add new webhook</p>
+  </li>
+  <li>
+    <p style="text-align:start">En el campo URL copiar el formato de otro repo y cambiarle el nombre del sitio</p>
+  </li>
+  <li>
+    <p style="text-align:start">Para completar el campo Secret token:</p>
+    <ol>
+      <li>
+        <p style="text-align:start">Ir a gethen, terminal de ruby y buscar el sitio <code>s = Site.find_by name: "nombre-del-sitio"</code></p>
+      </li>
+      <li>
+        <p style="text-align:start">Luego <code>s.roles.first.token</code></p>
+      </li>
+      <li>
+        <p style="text-align:start">Copiar el token y pegarlo en el campo Secret token de 0xa</p>
+      </li>
+    </ol>
+  </li>
+  <li>
+    <p style="text-align:start">Activar push events</p>
+  </li>
+  <li>
+    <p style="text-align:start">Dejar todo el resto como está</p>
+  </li>
+</ol>
+<p style="text-align:start">Si es necesario, hacer el mismo procedimiento tanto para el panel del sito de testing como para el del sitio de producción, usando los nombres tal cual los pusimos en el panel.</p>
+<h2 style="text-align:start" id="crear-ramas-de-trabajo">Crear ramas de trabajo</h2>
+<p style="text-align:start">En local crear y pushear las ramas de:</p>
+<ul>
+  <li>
+    <p style="text-align:start">theme: para commitear cambios de archivos scss, fonts y <code>_data/theme.yml</code></p>
+  </li>
+  <li>
+    <p style="text-align:start">content: para commitear cambios de esquemas de datos y archivos de textos de idioma</p>
+  </li>
+  <li>
+    <p style="text-align:start">nombre-sitio-nuevo.testing.sutty.nl: para llevar los cambios al sitio de testing</p>
+  </li>
+</ul>
 <p style="text-align:start"></p>
\ No newline at end of file