¶ About Urantiapedia
Urantiapedia is a collaborative website based on Wiki.js with the purpose of being a unified center for the dissemination of all knowledge regarding The Urantia Book.
¶ About registering on Urantiapedia and Blue Fields
If you want to collaborate on this project, the best way to contact us is by email at urantiapedia@gmail.com. Send a message stating your interest in the project and the Administrators will give you access.
Another way that will be available soon is through registration on the website Blue Fields, which is a website that has been created to unite and organize readers of The Urantia Book who wish to participate in intelligent, purposeful, and altruistic projects around the world. Once registered, the project team will contact you. The Urantiapedia project on Blue Fields can be accessed here: Urantiapedia on Blue Fields. However, this website is not 100% operational so contact via email is recommended.
¶ About GitHub
GitHub is a platform for version control in collaborative projects, especially code or web content projects.
The Urantiapedia project on GitHub (https://github.com/JanHerca/urantiapedia) is a project that contains all of the content of the website, as well as an application (Urantiapedia Tools) to help automate content creation. The Urantiapedia-backup project (https://github.com/JanHerca/urantiapedia-backup) is the mechanism used to be able to perform mass uploads of content.
¶ Who is this manual for?
This manual is intended for users called administrators, or admins for short, users who meet the following requirements:
- users registered on GitHub.
- users authorized as admins by the team that runs the Urantiapedia project.
- users registered on Urantiapedia. Only another admin user can register a user as admin.
- users with knowledge of Linux, Docker, Kubernetes, Git and GitHub.
- users with knowledge of The Urantia Book at least in one language in which it is published, and preferably with a good level of the English version.
- users who wish to collaborate selflessly in the incorporation of information related to The Urantia Book in Urantiapedia.
Admin users are the only ones in charge of bulk-uploading changes to the Urantiapedia website during each milestone of the project. More about project milestones in Milestones of the project.
¶ GitHub workflow
The process will be as follows:
- “Editor-in-Chief” creates a fork (a copy in its own account) of Urantiapedia project on GitHub (https://github.com/JanHerca/urantiapedia) and Urantia-backup project on GitHub (https://github.com/JanHerca/urantiapedia-backup). The first is a project that contains all the files. The second contains only the files that are synchronized with the Urantiapedia website.
- “Editor-in-Chief” creates a local copy of both projects on PC. The local copy must be of the latest version of Urantiapedia content (the master branch). This is done first through a clone action and later through pulls actions to the project, that downloads any change to the local copy.
- “Editor-in-Chief” makes changes in the local copy to the files indicated in this manual and in the way explained. “Editor-in-Chief” makes commmits to the local copy.
- “Editor-in-Chief” sends changes to his GitHub account through a push action.
- “Editor-in-Chief” performs a pull request in GitHub web to the original projects.
- The pull requests of “Editors-in-Chief” are reviewed by “Administrators”, who are in charge of doing a merge with the main branch (master) of all those changes that are correct. Any changes that are not correct will be rejected and “Editors-in-Chief” will be notified to fix them.
- When changes that are OK and “Administrator” has done the merge, any changes to the Urantiapedia-backup project are automatically synchronized with the website. Now changes are visible to all, in order to check and validate that they are correct.
- The process is repeated as many times as needed, returning to point 2.
¶ Setting up the Urantiapedia project
Before any work in Urantiapedia using GitHub you must set up all the needed tools. Check Setting up GitHub project.
¶ Content of Urantiapedia project at GitHub
To know the content of the GitHub project and its structure, check Content of GitHub project.
¶ Tasks
To know about the milestones of the project check Milestones of Urantiapedia.
Once we have the input in the correct folders, for each language, the steps to take in Milestone I are:
- Translating Paramony from English to the target language. Check Translation of Paramony.
- Translating and reviewing Topic Index from English to the target language. Check Translation an revision of Topic Index.
- Obtaining a public-domain translation of The Bible in the target language. Check Obtaining The Bible.
- Converting The Urantia Book from HTML to JSON without footnotes. Check Conversion to JSON.
- Adding Paramony footnotes to The Urantia Book in JSON. Check Adding Paramony footnotes.
- Converting Topic index from TXT to Wiki.js. Check Converting Topic Index.
- Converting The Urantia Book from JSON with footnotes to Wiki.js including references to topics. Check Converting The Urantia Book.
- Converting The Bible from LaTeX to Wiki.js with footnotes. Check Converting Bible.
- Commiting changes to Urantiapedia-backup project. Check Bulk upload content to Urantiapedia.
Editors-in-Chief and Assistant Editors perform tasks 1-3. Admins perform tasks 4-9.
¶ External links
- Urantiapedia Tools - GitHub project
- Urantiapedia-backup - GitHub project
- Urantia Foundation
- Blue Fields
- Wiki.js