libretube

Descripción

Este repositorio contiene el sitio web LibreTube, ubicado en https://lablibre.tuxfamily.org/.

Generar LibreTube

Instalación de dependencias

Puedes generar LibreTube en tu ordenador. Para ello necesitas tener los siguientes programas instalados:

• Pelican. Es el generador de páginas
• Python. Es el lenguaje de programación en el que está escrito Pelican.
• PHP. Lenguaje de programación usado para el buscador y formulario de comentarios.
• Markdown. Markdown es el lenguaje de marcado ligero en el que están escritos los artículos y páginas.
• Jinja2. Un motor de plantillas muy rápido y expresivo.
• Babel. Para la traducción del tema de la página.
• BeautifulSoup4. Requerido por el complemento tipue-search.

Instalar virtualenv con:

Distros basadas en Debian:

$ sudo apt install virtualenv

Distros basadas en Arch:

$ sudo pacman -S python-virtualenv

No es realmente necesario, pero es muy recomendable instalar GNU Make. En la siguiente sección se asume que tienes Make instalado.

• En sistemas operativos basados en Arch se puede instalar con la instrucción:

  $ sudo pacman -S make
  

• En sistemas operativos basados en Debian se puede instalar con la instrucción:

  $ sudo apt install make
  

Generar el contenido

Tras instalar las dependencias, puedes generar el blog ejecutando las siguientes órdenes:

1. git clone https://notabug.org/heckyel/libretube
2. cd libretube
3. virtualenv -p python3 venv
4. source venv/bin/activate
5. pip install -U -r requirements.txt
6. (cd libretube-theme && make compile)
7. cp -v Makefile.example Makefile
8. make html

Tras completar estos pasos, el blog estará disponible en la carpeta output. Abre el archivo output/index.html con tu navegador favorito para ver el blog.

Colaboración

Escribir un artículo

Si quieres publicar un artículo en LibreTube, puedes realizar un pull request o mandarme el artículo por correo electrónico. Si el artículo es interesante, puede que lo acepte.

Si no sabes cómo funciona Pelican, puedes mándame el artículo por correo sin preocuparte por el formato. Si quieres hacer un pull request, debes utilizar los metadatos de Pelican y escribir el artículo en Markdown. A continuación se muestra un ejemplo.

Author: Nombre de la autora
Category: Python
Date: 2017-12-03 10:20
Slug: titulo-del-artículo
Tags: pelican, publishing
Title: Título del artículo

Este es el contenido del artículo. Puedo usar la sintaxis de
[Markdown](https://es.wikipedia.org/wiki/Markdown)

El contenido de LibreTube se encuentra bajo dominio público (CC0 1.0 Universal). Si quieres publicar tu artículo usando otra licencia, indícalo.

Cuando escribas un artículo intenta utilizar etiquetas y categorías que ya existan, no utilices el nombre de la categoría del artículo también como etiqueta.

Si necesitas alguna funcionalidad especial (como un vídeo, una imagen de cabecera...) intenta utilizar complementos o funcionalidades que ya estén presentes en el blog. Consulta ejemplos de artículos que hacen uso de estos.

Hacer una traducción

Copia el archivo que quieres traducir y añade el código del idioma (por ejemplo .de para el alemán) antes de la extensión .md. Traduce el contenido del artículo o la página. Cuando termines, cambia los metadatos que hagan falta (título, autor, etc.) y añade el metadato Lang con el valor del código del idioma de la traducción. A continuación se muestra un ejemplo.

Author: nameauthor
Date: 2017-02-28 01:11
Lang: de
Slug: reflexión-sobre-los-medios-de-comunicación
Tags: Bücher, Fernsehen, freie Software, Internet, Kommentar, Medien
Title: Kommentar zu der Medien

Heutzutage gibt es viele Medien, die vorher nicht existierten. Das [...]

Mejora de la página

También puedes mejorar la apariencia y funcionalidad de la página. Simplemente crea un pull request. Antes de hacerlo, te recomendamos conocer cómo se organiza la estructura de directorios. También es recomendable comprobar si el código HTML es válido ejecutando make validate en la carpeta del proyecto (debes tener GNU Make y html5validator instalados). También es necesario tener instalado Java para que funcione html5validator:

$ sudo pacman -S jdk8-openjdk jre8-openjdk-headless

Comprobar versión de Java:

$ java -version
openjdk version "1.8.0_121"
OpenJDK Runtime Environment (IcedTea 3.3.0) (Hyperbola GNU/Linux-libre build 8.u121_3.3.0-1.hyperbola4-x86_64)
OpenJDK 64-Bit Server VM (build 25.121-b13, mixed mode)

Información de licencias

El contenido de este sitio web se encuentra bajo dominio público, excepto donde se especifique lo contrario.

Todo el código es software libre; se encuentra bajo la licencia AGPLv3, salvo las siguientes excepciones:

• Licencias de JavaScript. La información sobre las licencias de JavaScript se encuentra en el archivo content/pages/libreJS.md en forma de tabla preparada para ser leída por LibreJS.
• Todo lo que hay en el directorio libretube-theme se encuentra bajo la licencia GPLv3.

• Los siguientes complementos para Pelican (se encuentran en el directorio plugins):

  • another_read_more_link. Bajo la licencia Apache License, Version 2.0.
  • compressor. Bajo la licencia AGPLv3.
  • get_app_version. Bajo la licencia GPLv3.
  • i18n_subsites. Bajo la licencia GPLv3.
  • Neighbor Articles Plugin for Pelican. Bajo la licencia GPLv3.
  • pelican-css-js. Bajo la licencia GPLv3.
  • sitemap. Bajo la licencia AGPLv3.
  • tag-cloud. Bajo la licencia AGPLv3.
  • tipue-search. Bajo la licencia AGPLv3.

Preguntas frecuentes

¿Dónde esta alojado el repositorio con el código fuente?

Está alojado en https://libregit.org/heckyel/libretube, y hay copias en otros lugares:

• https://notabug.org/heckyel/libretube

¿Y el sistema de comentarios?

LibreTube utiliza el sistema de comentarios Hashover, el cual es software libre:

• Código fuente del lado del servidor
• Código JavaScript
• Diseño

¿Y los vídeos?

Los vídeos que contiene LibreTube no se encuentran en este repositorio por varias razones:

• No es nada útil añadir los vídeos al repositorio, pues Git no está hecho para controlar los cambios en los vídeos. Además, normalmente no se suelen modificar los vídeos ya creados.
• Solo harían que este repositorio fuera más pesado aún.
• Algunos vídeos no se encuentran alojados en el servidor de LibreTube.

La siguiente tabla contiene algunos de los vídeos que se encuentran en LibreTube:

Título	Fuente
Citizenfour	https://archive.org/download/libreweb/citizenfour-spanish.webm
¿Cómo generar Freak Spot?	https://archive.org/download/libreweb/freakspot.webm
Locutus de GNU	https://archive.org/download/libreweb/locutus.webm
Montar Android en Hyperbola	1080p.https://archive.org/download/libreweb/android-uucp.webm 480p.https://archive.org/download/libreweb/android-uucp-480.webm
Prompt avanzado	https://archive.org/download/libreweb/0001-15599.webm
RMS en dominio digital	https://archive.org/download/libreweb/StallmanenDominioDigital.webm
Sin parar	https://archive.org/download/libreweb/sin_parar.webm