seagl.github.io
1.0.0
Este es el código fuente de un sitio web disponible en https://seagl.org.
Utiliza Jekyll como generador de sitios estáticos con GitHub Pages.
El sitio se representa automáticamente cada vez que se envía código al repositorio compartido en GitHub.
Básicamente, los pasos para actualizar el sitio (para publicar una nueva entrada de blog, por ejemplo) son:
Hay instrucciones para cada uno de estos pasos a continuación. Las instrucciones asumen que alguien con menos experiencia técnica/en GitHub está realizando el trabajo. Aquellos con más experiencia pueden extrapolar en consecuencia. :-)
Si bien probablemente puedas trabajar directamente en este repositorio, las mejores prácticas son que no lo hagas. En su lugar, puede bifurcar o clonar el repositorio y luego realizar cambios en esa copia. Esto permite realizar pruebas antes de realizar cambios en vivo y reduce el riesgo de que un cambio mal formateado o redactado se escape al mundo.
Para bifurcar el repositorio:
¡Voilá! Eso es todo lo que hay que hacer.
Si está agregando una nueva publicación de blog, siga estas reglas de nombre de archivo:
_posts .YYYY-MM-DD . Esto es muy importante ya que controla el orden en el que el sitio web muestra las publicaciones del blog.--future cuando pruebe los cambios. Por el momento, también es necesario que active una reconstrucción del sitio en la fecha programada o después para que aparezca la publicación. Esto se puede hacer con: git commit -m 'rebuild pages' --allow-empty && git push origin main o realizando cualquier cambio real en el sitio.- ) y luego un título de la publicación delimitado por guiones. Este título no se muestra. Es solo para nombrar el archivo. Por favor que sea breve pero descriptivo..md para indicar que la publicación está redactada en formato Markdown. (y solo redacte publicaciones usando Markdown)Según estas reglas, una publicación de blog que anuncie la apertura de la PPC de 2017 podría tener un nombre de archivo de:
2017-06-19-CFP-open.md
Agregue también lo siguiente en la parte superior de su archivo:
---
layout: post
title: 'Example Title'
status: publish
type: post
published: true
categories: news
tags: '2013'
---
Establezca title para el título de la publicación de su blog y edite tags para incluir el año de la conferencia al que está asociada la publicación (vacío si no hay ninguna). Deje el resto de los valores como están.
Para el contenido real del archivo, puede realizar cambios en la interfaz web de GitHub o en su máquina local.
_posts ).Create a new fileCreate a new fileCommit changes debajo de la interfaz de edición.# ) seguida de un número de problema ( #74 ). Esto se vinculará automáticamente en la solicitud de extracción, lo cual es realmente útil.TBD (se supone que aquellos que usan git en sus máquinas locales ya lo saben; lo completarán más adelante)
Pruebe todos los cambios localmente antes de enviarlos a GitHub.
Al iniciar un servidor de desarrollo local, su copia del sitio estará disponible en http://localhost:4000. Hay algunas formas de ejecutar el servidor. ¡Haz tu elección!
Dependencias:
Configuración única:
bundle installInicie el servidor:
bundle exec jekyll serve --watch Para obtener una vista previa de publicaciones no publicadas y con fecha futura, agregue --future --unpublished al comando anterior.
Dependencias:
docker con podman )Configuración única:
docker build --tag ' seagldev ' ' . 'Inicie el servidor:
docker run --rm --interactive --tty --publish ' 4000:4000 ' --volume " $PWD :/usr/src/app " ' seagldev ' Para obtener una vista previa de las publicaciones no publicadas y con fecha futura, agregue --future --unpublished al final del comando anterior.
Puede enviar un PR en la interfaz de GitHub o desde su máquina local.
Pull requests .New pull request button .Create pull request .# ) seguida de un número de problema ( #74 ). Esto se vinculará automáticamente en la solicitud de extracción, lo cual es realmente útil.[Allow edits from maintainers](https://docs.github.com/en/free-pro-team@latest/github/collaborating-with-issues-and-pull-requests/allowing-changes-to-a-pull-request-branch-created-from-a-fork) para que otros miembros del equipo puedan realizar modificaciones, si es necesario.Create pull request .TBD (se supone que aquellos que usan git en sus máquinas locales ya lo saben; lo completarán más adelante)
Ahora alguien (quizás usted, si tiene ese nivel de acceso al repositorio) debe revisar y luego fusionar su solicitud de extracción.
Una vez que su solicitud de extracción se combine, se publicará en el sitio web.
NOTA BENE : La fusión en sí no desencadenará la reconstrucción del sitio. Para reconstruir el sitio, debe enviar un compromiso vacío como este:
git commit --allow-empty -m " Rebuild the site, please " && git push Agregue su imagen al directorio img/posts/ , luego use el siguiente Markdown:
![ Example description ] ( /img/posts/example.jpg )Consejos:
Para alinear la imagen hacia un lado, agregue la clase align-left o align-right :
![ Example description ] ( /img/posts/example.jpg ) {:.align-left}Por el bien de los tiempos de carga de la página, cambie el tamaño de las imágenes a un tamaño razonable antes de usarlas en una publicación.
Las conferencias pasadas se archivan estáticamente como colecciones Jekyll:
archive-conferencesarchive-sessionsPara crear el archivo de un año determinado, primero importe los datos del cronograma:
bundle exec rake import[2020]—luego edite los archivos comprimidos a mano si es necesario realizar alguna corrección.
