¶ Acerca de la Urantiapedia
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.
¶ Acerca del registro en Urantiapedia y Blue Fields
En caso de querer colaborar en este proyecto el mejor medio de contacto es el correo electrónico urantiapedia@gmail.com. Envía un mensaje comentando tu interés en el proyecto y los Administradores se encargarán de darte acceso.
Otra forma que estará disponible pronto será a través del registro en la web Blue Fields, que 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. Una vez registrado el equipo del proyecto se pondrá en contacto contigo. El proyecto Urantiapedia en Blue Fields se accede aquí: Urantiapedia en Blue Fields. Sin embargo, esta web no está operativa al 100% por lo que se recomienda el contacto a través del correo electrónico.
¶ Acerca de GitHub
GitHub es una plataforma para el control de versiones en proyectos colaborativos, especialmente en proyectos de código o de contenido web.
El proyecto Urantiapedia en GitHub (https://github.com/JanHerca/urantiapedia) es un proyecto que contiene todo el contenido del sitio web, además de una aplicación (Urantiapedia Tools) para ayudar a automatizar la creación de contenido. El proyecto Urantiapedia-backup (https://github.com/JanHerca/urantiapedia-backup) es el mecanismo usado para poder realizar subidas masivas de contenido.
¶ A quién va dirigido este manual
Este manual va dirigido a los usuarios denominados «Editores Asistentes», es decir, aquellos usuarios que cumplen los siguientes requisitos:
- No tienen una cuenta en esta web. Sólo pueden usar GitHub o el correo electrónico para enviar solicitudes de cambios.
- Tienen un buen conocimiento de El Libro de Urantia al menos en un idioma en los que está publicado, pero mejor si es inglés y en un segundo idioma en el que esté traducido el libro.
- Escriben bien y con corrección.
- No tienen conocimientos específicos de informática.
- Desean colaborar de forma desinteresada en la incorporación de información relativa a El Libro de Urantia en la Urantiapedia.
¶ Dos maneras de colaborar
Los «Editores Asistentes» pueden colaborar de dos maneras a su conveniencia.
- Trabajando a través de la plataforma GitHub, preferentemente a través de la propia web de GitHub, haciendo ahí cambios y adiciones.
- Enviando su trabajo por email.
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 |
|---|---|---|
| En la web de GitHub | El editor queda registrado 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. |
| Por email | Se puede trabajar sin red. Se crean contenidos más rápido. |
El editor no aparece como creador de los cambios. |
A continuación detallamos cómo se realizarían las acciones necesarias en una y otra forma de colaboración.
¶ Procedimiento de trabajo en GitHub
El proceso de trabajo en GitHub se detalla en el Manual de uso de los proyectos de Urantiapedia en GitHub. Se debería empezar echando un vistazo a los Primeros pasos en GitHub y luego continuar con el paso de Trabajar directamente desde la web de GitHub. El resto de páginas de este manual no interesan a los «Editores Asistentes».
¶ Colaboración por email
Para enviar cambios por email es imprescindible poder ver el contenido actual del proyecto Urantiapedia, para tener ese contenido como referencia a la hora de crear un correo con contenido nuevo o modificado. Para ello tienes varias opciones que detallamos a continuación.
¶ Consultar el contenido de Urantiapedia en GitHub
Entra en la web del proyecto Urantiapedia en GitHub: https://github.com/JanHerca/urantiapedia. Esa página es pública y podrás ver que imita un Explorador de archivos. Puedes hacer clic en las carpetas del proyecto y finalmente en archivos del proyecto para ver su contenido. Un fichero Marckdown con un artículo se puede ver en modo Preview, para leerlo más cómodamente, o en modo Code, donde puedes ver el código real del archivo.
¶ Descargar los ficheros desde GitHub
Entra en la web del proyecto Urantiapedia en GitHub: https://github.com/JanHerca/urantiapedia. Esta página es pública, como ya hemos dicho. Cualquiera puede descargar los ficheros. Tienes dos opciones:
- Descargar todo el proyecto. Es la mejor opción si vas a trabajar en muchas partes de Urantiapedia.
- Descargar sólo los ficheros necesarios. Esta opción es más sencilla si sólo vas a ayudar en una pequeña parte.
¶ Descargar todo el proyecto
Para descargar todo el proyecto sigue estos pasos:
- Entra en la web del proyecto Urantiapedia en GitHub: https://github.com/JanHerca/urantiapedia.
- Haz clic en el botón verde que dice Code y luego 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 por defecto de descompresión.
Una vez que los archivos estén descomprimidos, ya puedes ver los archivos. La mayoría son archivos de texto que puedes abrir con el Bloc de Notas o cualquier otro editor de texto similar.
¶ Descargar sólo los ficheros necesarios
En el caso de que no quieras descargar todo el proyecto, puedes hacer esto:
- Entra en la web del proyecto Urantiapedia en GitHub: https://github.com/JanHerca/urantiapedia.
- 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, entra en el archivo y haz clic en el botón Download raw file. 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.
¶ Editar los ficheros en un editor de texto
Si lo que estás haciendo son correcciones a archivos no necesitas editar los archivos originales para enviarlos por email. Es suficiente con copiar un extracto de un párrafo que veas incorrecto y señalar qué es lo que está mal y lo que debería verse.
Si lo que vas a enviar por correo es una modificación importante a un archivo o archivos nuevos, entonces para editar esos archivos es mejor usar una herramienta que pueda editar archivos de tipo texto, una buena recomendación es 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:
- El Bloc de Notas que viene por defecto con Windows.
- Visual Studio Code: https://code.visualstudio.com/
- Notepad++: https://notepad-plus-plus.org/
- Atom: https://atom.io/
- Sublime: https://www.sublimetext.com/
Todos ellos son de uso gratuito.
Si utilizas Visual Studio Code aquí tienes algunos consejos útiles:
- Durante la instalación, se recomienda marcar la opción Add action ‘Open with Code’ to folder context menu (Agregar acción ‘Abrir con Code’ al menú contextual de la carpeta) si eres usuario de Windows. Con esto, se agregará una opción al menú contextual de las carpetas de Windows para poder abrir fácilmente el contenido de cualquier carpeta en el editor. De este modo si haces clic derecho en la carpeta urantiapedia puedes usar la opción Open folder para abrir el proyecto directamente en VS Code.
- Una extensión que puede hacerte la vida más fácil es Sync Scroll. Esta extensión permite desplazarse en varios archivos en paralelo, algo que ayuda mucho a la hora de editar en varios idiomas al mismo tiempo. Para instalar la extensión, ve al panel Extensions (Extensiones). Escribe Sync Scroll en el cuadro de búsqueda. Haz clic en el botón Install (Instalar) en la extensión. Ahora tendrás un botón en la barra de estado para activar o desactivar Sync Scroll. Es necesario tener varios ficheros abiertos en paralelo para ver esta opción. Para ello haz clic con el botón derecho del ratón en un fichero abierto en la lista de ficheros y selecciona Open to the side (Abrir en el lateral).
¶ Envío de cambios a los administradores
Simplemente envía un correo a urantiapedia@gmail con los archivos que has modificado o que quieres añadir. En el caso de ficheros a añadir indica en el mensaje del correo dónde deberían añadirse. Si son simples correcciones también las puedes añadir en el mensaje del correo, no es necesario introducirlas en un archivo.
Posteriormente los administradores se harán cargo de estos envíos y actualizarán la página web Urantiapedia con aquellos cambios que consideren correctos. Se te notificará cuándo están listos los cambios en la web, lo cual fácilmente puede tardar unos días.
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 el procedimiento de Trabajar directamente desde la web de GitHub.
¶ Tareas
La lista de tareas y los manuales sobre cada tarea están indicadas en el manual para Administradores. El índice es el mismo que se indica allí, así que consulta ese manual para más referencias.
¶ Enlaces externos
- Urantiapedia - Proyecto principal en GitHub
- Urantiapedia-backup - Proyecto para cargas masivas en GitHub
- Fundación Urantia
- Blue Fields
- Wiki.js