¶ 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 project on GitHub is a project created to serve as a quick start-up procedure for Urantiapedia 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 "Assistant Editors", or users that comply with these requirements:
- registered users with an account on Blue Fields and on Urantiapedia. They do not need a GitHub account.
- authorized as project collaborators by the team that runs the project on Blue Fields platform.
- authorized as "Assitant Editors" by "Administrators" of Urantiapedia.
- with 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.
¶ Download the files from GitHub
GitHub is a webpage for creating collaborative projects, usually about software development. The project files for Urantiapedia are here: Urantiapedia.
This project is public. Anybody can create a copy of the project, add contributions to the copy, and send the changes. Maintainers of the project then can accept or reject changes and add them to existing content. GitHub has tools that make this very easy and fast.
To download the files you have two options:
- Download everything in the project. This is the best option for contributors that are going to work in several tasks of Urantiapedia.
- Download only the files needed. This option is more simple for contributors that are going to help just in one task.
¶ Downloading all the project
To download everything go to main page of the project in GitHub and in the green button that says Code, select the option Download ZIP. The browser will start downloading a ZIP file with the most updated content. Save it in any folder or check your Downloads folder to locate the file.
Be aware that it can be a long download because the project contains a good amount of files. You should have at least 200-300 MB of free space in your computer.
Once download has ended you will have a file called urantiapedia-master.zip. This is a compressed file so please uncompress it in any folder. If you don't know how to uncompress a ZIP file it is very easy. In Windows, for example, right click with the mouse in the file and select Extract all to open the uncompressing tool.
Once the files are uncompressed you are ready to go to next step with Text Editor.
¶ Downloading only required files
In the case that you don't want to download all the project, you can do this.
Go to this URL in the browser: https://github.com/JanHerca/urantiapedia/tree/master/input/
This is the path with the files. You can move through folders in GitHub page. When you need one file, right click with the mouse on the name of it and select Save link as. That will brings you the dialog to save each file.
This way you can choose which files you want to download, which is a better option if you do not have very much free space in your hard drive or you do not require the full project.
Now we can edit them in a Text Editor.
¶ Edit the files in a Text Editor
To edit the files we can use any tool that can edit TXT files. However, it is highly recommended to use software that can show hidden characters and white space. It is important to show them because this extra chars are used to create the structure of files and if we remove them we can corrupt files.
The most recommended software is Visual Studio Code, but others can make the job:
- Visual Studio Code: https://code.visualstudio.com/
- Notepad++: https://notepad-plus-plus.org/
- Atom: https://atom.io/
- Sublime: https://www.sublimetext.com/
All of them are free to use.
The steps to setup the editor are these:
- Download Visual Studio Code. Go the website and click in Download button.
- Install it. During installation it is recommended to check the Add action 'Open with Code' to folder context menu if you are a Windows user. With this an option will be added to your context menu of Windows folders so you can easily open the content of a any folder in the editor.
- Open it. First time it is opened you can set up some settings. Skip them all.
- Go to File menu and select Open Folder. Then select the folder with the full project or with the individual files you have downloaded.
- Open any of the files.
- One extension that can make life easier is Sync Scroll. This extension allows to scroll in several files in parallel, something that helps a lot when editing in mutiple languages at the same time.
- To install the extension go to Extensions panel. Type Sync Scroll in search box. Click in Install button in the extension. Now there is a button in the status bar to switch the Sync Scroll ON or OFF. It is needed to have several opened files in parallel to see the option. For this right-click in any opened file in the list of opened ones, and select Open to the side.
¶ Content of Urantiapedia project at GitHub
To know the content of the GitHub project and its structure, check Content of GitHub project.
¶ Sending changes to Administrators
Collaboration through GitHub has the advantage that anything can be done easily through the GitHub web. But to make Assistant Editors work really simple, they can send the files edited by sending them in an email to any of the maintainers in the project.
If you have been in contact with any of the administrators of the project, you can send them directly your work. Then it is really easy for maintainers to update the Urantiapedia GitHub website with the new content, and through it, to update Urantiapedia site. You will be notified when the changes are made in the web, that usually takes no more than an hour, to check that your changes have been updated correctly.
¶ 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.
Chief Editors and Assistant Editors perform tasks 1-3. Admins perform tasks 4-9.
¶ Links
- Starting with Urantiapedia
- Urantiapedia Content
- Urantiapedia - Languages supported
- Admin help
- Developers help
- Chief Editors help
- Assistant Editors help
- Urantiapedia status - Current progress of the project
¶ External links
- Urantiapedia Tools - GitHub project
- Urantiapedia-backup - GitHub project
- Urantia Foundation
- Blue Fields
- Wiki.js