Colaborar en hackerspace.cl: Difference between revisions

From HSS
(Código)
(Semantic line breaks)
 
Line 16: Line 16:
*<code>src/views/</code>: Las páginas en formato markdown
*<code>src/views/</code>: Las páginas en formato markdown
*<code>routes.rb</code>: Rutas de estas páginas
*<code>routes.rb</code>: Rutas de estas páginas
Se recomienda escribir los documentos markdown con [https://sembr.org/ semantic line breaks] para facilitar la edición en un sistema de control de versiones como git. Lo cual consiste en escribir cada "idea" en una línea, idealmente en menos de 80 caracteres por línea. En la versión web del documento, se verá todo escrito por párrafos.


===Documentación Kramdown===
===Documentación Kramdown===

Latest revision as of 06:19, 24 March 2024

Video tutorial https://anfibio.hackerspace.cl/~libsys/tutorial_git_hackerspace.mp4

1. Registrarse en codeberg.org

2. Crear un fork de hackerspace.cl

3. Clonar tu fork de hackerspace.cl

git clone <tu fork>

4. Editar!

Rutas relevantes:

  • public/: Todo el contenido estático
  • src/views/: Las páginas en formato markdown
  • routes.rb: Rutas de estas páginas

Se recomienda escribir los documentos markdown con semantic line breaks para facilitar la edición en un sistema de control de versiones como git. Lo cual consiste en escribir cada "idea" en una línea, idealmente en menos de 80 caracteres por línea. En la versión web del documento, se verá todo escrito por párrafos.

Documentación Kramdown

5. Previsualizar ediciones

Instalar paquetes necesarios

Arch

pacman -S ruby ruby-bundler gcc glibc make

Debian

apt install ruby-full ruby-bundler gcc libc6-dev make

Correr proyecto

bundle config set --local path vendor/bundle
bundle install
bundle exec rackup # este es el que realmente lo corre

6. Enviar las modificaciones

git add <archivos>
git commit
git push origin main

7. Crear un Pull Request en Codeberg

https://codeberg.org/hackerspacestgo/hackerspace.cl/pulls

8. Obtener modificaciones posteriores

Si posteriormente requieres actualizar tu propio repo con las nuevas actualizaciones en el repo original.

La primera vez debes hacer esto para añadir el origen oficial.

git remote add upstream https://codeberg.org/hackerspacestgo/hackerspace.cl.git

Luego, cada vez que quieras actualizar, haz lo siguiente:

git fetch upstream
git rebase upstream/main

Acerca de

Extraído de https://codeberg.org/hackerspacestgo/hackerspace.cl