¶ 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 Blue Fields
Blue Fields is a website that has been created to join and organize readers of The Urantia Book who wish to collaborate in smart, purposeful and altruistic projects all over the world. It is the website that manages register and collaboration between volunteers of Urantiapedia.
¶ About GitHub
Urantiapedia has two public projects in GitHub: Urantiapedia and Urantiapedia-backup created to serve as a quick start-up procedure for initial content. It contains files in certain formats and software that help automate the creation of initial content.
¶ Who is this manual for?
This manual is for users called “Editors-in-Chief”, or users that comply with these requirements:
- They have an account in this with editing permissions, and another in GitHub.
- They can add content to both Urantiapedia projects in GitHub: Urantiapedia and Urantiapedia-backup. They can do bulk load of changes using the second project.
- They have a good knowledge of Git and GitHub management.
- They have good knowledge of The Urantia Book in at least one language in which it is published, but better if it is English and a second language on which the book is translated.
- They wish to collaborate in a selfless way in the addition of information related to The Urantia Book in the Urantiapedia.
¶ GitHub workflow
The process for a “Editor-in-Chief” will be as follows:
- Creates a fork (a copy in its own account) of Urantiapedia projects on GitHub:
- Creates a local copy of the 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 projects, that downloads any change to the local copy.
- Makes changes in the local copy of the Urantiapedia project to the files indicated in this manual and in the way explained. He or she makes commmits to the local copy.
- Sends partial changes (not ready to be uploaded to the web) to Urantiapedia project in GitHub through a push. When there is a set of changes ready for the web, synchronizes the local Urantiapedia project with local Urantiapedia-backup project and upload changes in GitHub through a push.
- Then creates a pull requests from the GitHub website for both projects: Urantiapedia and Urantiapedia-backup.
- This 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 are OK an “Administrator” do a merge of them and they are uploaded automatically to the web. They are usually available in a few minutes depending on the number of changes and their type.
¶ 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.
¶ Milestone I: The Urantia Book, the Bible and Topic Index
- 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.
Currently all tasks except 2 have been completed.
¶ Milestone II: Books, articles, study aids, schemas and indexes
- Create a catalog of books that are considered sources of The Urantia Book or contain interesting parallels. See Source Book Catalog.
- Get previous books. See Get “source” books.
- Create a catalog of articles written by readers. See Articles Catalog.
- Get previous articles. See Get Articles.
- Create a catalog of study aids. See Study Aids Catalog.
- Get the above study aids. See Get study aids.
- Create a catalog of diagrams. See Diagrams Catalog.
- Obtain the above diagrams in HTML image map format or preferably SVG. See Get Diagrams.
- Create the project image catalog. See Images Catalog.
¶ External links
- Urantiapedia Tools - GitHub project
- Urantiapedia-backup - GitHub project
- Urantia Foundation
- Blue Fields
- Wiki.js