Urantiapedia es una web colaborativa basada en Wiki.js con el propósito de servir de centro unificado de difusión de todo el conocimiento relativo a El Libro de Urantia.
Blue Fields es una web que ha sido creada para unir y organizar a lectores de El Libro de Urantia que desean participar en proyectos inteligentes, propositados y altruistas en todo el mundo. Es el sitio web que gestiona el registro y la colaboración entre los voluntarios de Urantiapedia.
Urantiapedia tiene dos proyectos públicos en GitHub: Urantiapedia y Urantiapedia-backup creados para servir de procedimiento rápido de creación inicial de contenidos. Contiene unos archivos en ciertos formatos y un software que ayudan a automatizar la creación de un contenido inicial.
Este manual va dirigido a los usuarios denominados «Editores Asistente», es decir, aquellos usuarios que cumplen los siguientes requisitos:
Los «Editores Asistente» pueden colaborar de dos maneras a su conveniencia.
Cualquiera de ambos métodos es igualmente aceptable. La diferencia que supone una u otra forma de colaboración se detalla en esta tabla:
Modo | Ventajas | Desventajas |
---|---|---|
Por email | Se puede trabajar sin red Se crean contenidos más rápido Se pueden editar los archivos de apoyo (carpeta /input ) |
El editor no aparece como creador de los cambios en la web |
En la web | El uso de los editores visuales facilita la edición El editor aparece como creador de los cambios |
Requiere acceso de red El guardado es más lento y sólo se puede ir página a página Sólo se pueden editar cosas que sean páginas de la web |
A continuación detallamos cómo se realizarían las acciones necesarias en una y otra forma de colaboración.
GitHub es una página web para crear proyectos colaborativos, normalmente sobre desarrollo de software. Los ficheros de proyecto para la Urantiapedia están aquí: Urantiapedia.
El proyecto es público. Cualquiera puede descargar los ficheros. Tienes dos opciones:
Para descargar todo el proyecto navega a la página del proyecto en GitHub y en el botón verde que dice Code, haz click y selecciona la opción Download ZIP (Descargar ZIP). El navegador empezará a descargar el fichero ZIP con el contenido más actualizado. Guárdalo en cualquier carpeta o comprueba tu carpeta de Descargas para localizar el fichero.
Ten en cuenta que puede ser una descarga larga porque el proyecto contiene un buen número de archivos. Deberías tener al menos 2-3 GB de espacio libre en el PC.
Una vez finalizada la descarga, tendrás un fichero llamado urantiapedia-master.zip
. Este es un archivo comprimido, así que descomprímelo en cualquier carpeta. Si no sabes cómo descomprimir un archivo ZIP es muy fácil. En Windows, por ejemplo, haz clic con el botón derecho del ratón en el fichero y selecciona Extraer todo para abrir la herramienta de descompresión.
Una vez que los archivos estén descomprimidos, estás listo para ir al siguiente paso con el editor de texto.
En el caso de que no quieras descargar todo el proyecto, puedes hacer esto.
Navega a esta URL: https://github.com/JanHerca/urantiapedia/tree/master/
Esta es la página de GitHub con los archivos. Puedes moverte por las carpetas en la página de GitHub. Cuando necesites un archivo, haz clic derecho con el ratón sobre el nombre del mismo y selecciona Save link as (Guardar enlace como). Eso abrirá el cuadro de diálogo para guardar cada fichero.
De esta manera puedes elegir qué ficheros quieres descargar, lo cual es una mejor opción si no tienes mucho espacio libre en tu disco duro o no requieres el proyecto completo.
Ahora podemos editar los archivos en un editor de texto.
Para editar los ficheros podemos usar cualquier herramienta que pueda editar archivos de tipo texto. Sin embargo, se recomienda encarecidamente utilizar un software que pueda mostrar caracteres ocultos y espacios en blanco. Es importante mostrarlos porque estos caracteres adicionales se utilizan para crear la estructura de los archivos y si los eliminamos podemos dañar los archivos.
El software más recomendado es Visual Studio Code, pero otros pueden hacer el trabajo:
Todos ellos son de uso gratuito.
Si utilizas Visual Studio Code los pasos para configurarlo son estos:
Para conocer el contenido del proyecto en GitHub y cómo está estructurado, consulta Contenido del proyecto de GitHub.
La colaboración a través de GitHub tiene la ventaja de que cualquier cosa se puede hacer fácilmente a través de la web de GitHub. Pero para hacer que los Editores asistentes funcionen de manera realmente simple, pueden enviar los archivos editados a través del correo electrónico a cualquiera de los administradores del proyecto o bien a urantiapedia@gmail.com.
Si has estado en contacto con alguno de los administradores del proyecto, puedes enviarles directamente tu trabajo. Posteriormente, resulta muy sencillo para los administradores actualizar el sitio web de Urantiapedia en GitHub con el nuevo contenido y, a través de él, actualizar la página Urantiapedia. Se te notificará cuándo están listos los cambios en la web, lo que no suele tardar más de una hora, para que puedas comprobar que tus cambios se han actualizado correctamente.
Recuerda que si haces envíos por correo en la web no quedará reflejado que los cambios subidos los realizaste tú, sino que aparecerán como cambios de los Administradores. Si quieres que constancia de que tú hiciste cambios deberás usar la funcionalidad de esta propia web.
En este caso todas las tareas se realizan a través de esta web. Es necesario iniciar sesión con la cuenta de edición proporcionada, y seguir los manuales sobre cómo realizar ediciones:
Sobre las fases del proyecto consulta Fases de la Urantiapedia. Las tareas que pueden realizar los «Editores Asistente» son las que se indican aquí:
Actualmente las tareas 1 y 3 han sido completadas.