CRySoL
  • About
  • Archive
  • Publish
  • Recipes
  • Users
logo

recent

  • Tutorial básico de dig
  • Mini referencia de SQL con Postgres
  • Edición de vídeo desde consola con ffmpeg
  • Volcar (y recuperar) una base de datos PostgreSQL
  • Systemd service config overwride

categories

recipe tale
new cooking
challenge opinion
enquiry script
art event
offer quote
humor

tags

networking Python
embedded Arco
linux (the kernel of course) Molinux
MySQL VCS
Debian-devel security
Debian GNESIS
ripping drivers
emacs gstreamer
gnome ocio
sugarfree scapy
multimedia gtk
shell Ice
NDS graphics
uclmwifi proselitism
C++ patterns
Hurd Oreto
ceslcam LaTeX
mercurial platanada
Chumby Java
devel INGSOFT
blender android
git sysadm
jekyll drupal
pdf doublex
agile debian
puppet printer
virtualbox sudo
augeas latex
veewee vagrant
nautilus Ogre3D
schroot apt-mirror
cron ElasticSearch
logstash kibana
GPG pgp
bash eduroam
tmux docker
systemd PostgreSQL
ffmpeg Postgres
dig DNS

Publish Cómo publicar en CRySoL

Esta receta explica cómo crear posts en tu propio blog de CRySoL o colaborar con el sitio.

La web de CRySoL es estática. Se genera a partir de un conjunto de ficheros markdown y textile y se compila a HTML/CCS usando el programa jekyll.

Los fuentes del sitio se encuentran en un repositorio git alojado en github: https://github.com/CRySoL/CRySoL.github.io. Cuando se hace push a dicho repositorio, github ejecuta jekyll automáticamente y deja el resultado accesible en https://crysol.github.io y http://crysol.org, es decir, lo que estás viendo ahora.

Para crear un nuevo post basta crear un fichero en el directorio /_posts cuyo nombre tenga el formato YEAR-MONTH-DAY-title.MARKUP, siendo MARKUP el lenguaje en el que está escrito markdown, textile o html.

Estos ficheros tienen un «preámbulo» que incluye información con el título, autor, categorías, etiquetas, etc. Puedes encontrar más detalle en jekyll post front-matter, o simplemente mira el fuente de otro post existente.

A pesar de eso, cualquiera puede escribir en la web de CRySoL. Existen dos formas básicas de editar tu blog en esta web.

La forma fácil

github tiene un sencillo editor web, de modo que podrás escribir tus post directamente en el navegador. Ve a https://github.com/CRySoL/CRySoL.github.io/tree/master/source/_posts y pulsa en el botón “Add file”. Eso creará un nuevo fichero que puedes nombrar, editar y almacenar en el repositorio. Si está convenientemente formateado, en pocos minutos aparecerá en la página web.

La forma potente

El editor de github es muy simple, demasiado. Si quieres editar tus post con un editor de verdad y probar que el resultado es el que esperas puedes hacer algo más interesante.

Clona el repositorio a tu computador:

$ git clone https://github.com/CRySoL/CRySoL.github.io.git

Instala jekyll y sus dependencias:

$ sudo apt install jekyll

Arranca jekyll:

web.source$ jekyll serve -w

Y puedes ver el sitio generado en http://localhost:4000. Gracias al argumento -w el contenido se compila automáticamente con cualquier cambio. Esto es extremadamente lento porque jekyll compila toooodos los posts (más de 5 minutos en una máquina decente). Sin embargo, puedes usar la opción --limit-posts n para compilar únicamente los n últimos posts, de modo que podrás ver el resultado sin esperar demasiado.

Edita tu post (u otro contenido) y cuando todo esté correcto envía tus modificaciones a github.

$ git commit -a
$ git push

Colaboradores externos

Todo lo anterior solo funciona si tu cuenta de github pertenece al equipo de CRySoL.

Pero aunque no seas miembro del equipo aún puedes colaborar con CRySoL gracias a la forma en que funciona git. Sigue estos pasos:

  • Crea una cuenta en github y haz login
  • Ve a https://github.com/CRySoL/CRySoL.github.io
  • Pulsa el botón «Fork»

Ahora tienes una copia del repo de CRySoL en tu cuenta. A partir de ahí puedes aplicar todo lo explicado anteriormente sobre tu fork del repo. Cuando esté listo, debes solicitar a los administradores del repo original que integren tus cambios en el repo “oficial”. Para eso simplemente pulsa el botón «Pull Request» y espera a que un editor valide tus aportaciones.

Referencias

  • http://metajack.im/2009/01/23/blogging-with-git-emacs-and-jekyll

© 2023 CRySoL with help from Jekyll Bootstrap and Twitter Bootstrap. See site sources.
Generated at 2023-01-12 06:59:15 -0600
_built last-commit