¶ À propos d’Urantiapedia
Urantiapedia est un site Web collaboratif basé sur [Wiki.js](https://js .wiki/) dans le but de servir de centre unifié pour la diffusion de toutes les connaissances liées au Le Livre d’Urantia.
¶ À propos de l’inscription sur Urantiapedia et Blue Fields
Si vous souhaitez collaborer à ce projet, le meilleur moyen de contact est l’e-mail urantiapedia@gmail.com. Envoyez un message commentant votre intérêt pour le projet et les Administrateurs se chargeront de vous donner accès.
Un autre moyen qui sera bientôt disponible sera l’inscription sur le site Web Blue Fields, qui est un site Web qui a été créé pour unir et organiser les lecteurs de El Urantia. Book qui souhaitent participer à des projets intelligents, utiles et altruistes à travers le monde. Une fois inscrit, l’équipe du projet vous contactera. Le projet Urantiapedia sur Blue Fields est accessible ici : Urantiapedia on Blue Fields. Cependant, ce site Web n’est pas opérationnel à 100 %, un contact par e-mail est donc recommandé.
¶ À propos de GitHub
GitHub est une plateforme de contrôle de version dans les projets collaboratifs, notamment les projets de code ou de contenu Web.
Le projet Urantiapedia sur GitHub (https://github.com/JanHerca/urantiapedia) est un projet qui contient tout le contenu du site Web, plus une application (Urantiapedia Tools) pour aider à automatiser la création de contenu. Le projet Urantiapedia-backup (https://github.com/JanHerca/urantiapedia-backup) est le mécanisme utilisé pour effectuer des téléchargements massifs de contenu.
¶ À qui s’adresse ce manuel ?
Ce manuel est destiné aux utilisateurs appelés « Assistants Editeurs », c’est-à-dire les utilisateurs qui répondent aux exigences suivantes :
- Ils ont une bonne connaissance du Le Livre d’Urantia au moins dans une langue dans laquelle il est publié, mais mieux si c’est l’anglais et dans une seconde langue dans laquelle le livre est traduit.
- Ils écrivent bien et correctement.
- Ils n’ont pas de connaissances spécifiques en informatique.
- Ils souhaitent collaborer de manière désintéressée à l’incorporation d’informations liées au Livre d’Urantia dans Urantiapedia.
¶ Deux façons de collaborer
Les « assistants rédacteurs » peuvent collaborer de deux manières à leur convenance.
- Travailler via la plate-forme GitHub, de préférence via le site Web GitHub lui-même, en y apportant des modifications et des ajouts.
- Envoi de votre travail par email.
Les deux méthodes sont également acceptables. La différence entre l’une ou l’autre forme de collaboration est détaillée dans ce tableau :
| Mode | Avantages | Inconvénients |
|---|---|---|
| Sur le site GitHub | L’éditeur est enregistré comme créateur des modifications. | Nécessite un accès au réseau. La sauvegarde est plus lente et vous ne pouvez aller que page par page. |
| Par email | Vous pouvez travailler sans réseau. Le contenu est créé plus rapidement. |
L’éditeur n’apparaît pas comme l’auteur des modifications. |
Nous détaillons ci-dessous comment les actions nécessaires seraient menées dans chaque forme de collaboration.
¶ Procédure de travail dans GitHub
Le processus de travail dans GitHub est détaillé dans le manuel d’utilisation des projets Urantiapedia sur GitHub. Vous devriez commencer par jeter un œil à Démarrer sur GitHub, puis continuer avec l’étape de Travailler directement à partir du site Web GitHub. Le reste des pages de ce manuel n’intéresse pas les « assistants rédacteurs ».
¶ Collaboration par email
Pour envoyer des modifications par email, il est essentiel de pouvoir voir le contenu actuel du projet Urantiapedia, d’avoir ce contenu comme référence lors de la création d’un email avec du contenu nouveau ou modifié. Pour cela vous disposez de plusieurs options que nous détaillons ci-dessous.
¶ Consultez le contenu d’Urantiapedia sur GitHub
Accédez au site Web du projet Urantiapedia sur GitHub : https://github.com/JanHerca/urantiapedia. Cette page est publique et vous pouvez voir qu’elle imite un explorateur de fichiers. Vous pouvez cliquer sur les dossiers du projet et enfin sur les fichiers du projet pour afficher leur contenu. Un fichier Marckdown avec un article peut être visualisé en mode Preview, pour le lire plus confortablement, ou en mode Code, où vous pouvez voir le code réel du fichier.
¶ Téléchargez les fichiers depuis GitHub
Allez sur le site Web du projet Urantiapedia sur GitHub : https://github.com/JanHerca/urantiapedia. Cette page est publique, comme nous l’avons déjà dit. Tout le monde peut télécharger les fichiers. Vous avez deux options :
- Télécharger l’intégralité du projet. C’est la meilleure option si vous comptez travailler dans de nombreuses parties d’Urantiapedia.
- Téléchargez uniquement les fichiers nécessaires. Cette option est plus facile si vous n’aidez que dans une petite partie.
¶ Téléchargez l’intégralité du projet
Pour télécharger l’intégralité du projet, suivez ces étapes :
- Allez sur le site Web du projet Urantiapedia sur GitHub : https://github.com/JanHerca/urantiapedia.
- Cliquez sur le bouton vert qui dit Code, puis sélectionnez l’option Download ZIP (Télécharger ZIP). Le navigateur commencera à télécharger le fichier ZIP avec le contenu le plus à jour. Enregistrez-le dans n’importe quel dossier ou vérifiez votre dossier Téléchargements pour localiser le fichier.
Veuillez noter que le téléchargement peut être long car le projet contient un bon nombre de fichiers. Vous devez disposer d’au moins 2 à 3 Go d’espace libre sur votre PC.
Une fois le téléchargement terminé, vous aurez un fichier appelé « urantiapedia-master.zip ». Il s’agit d’un fichier compressé, alors décompressez-le dans n’importe quel dossier. Si vous ne savez pas comment décompresser un fichier ZIP, c’est très simple. Sous Windows, par exemple, cliquez avec le bouton droit sur le fichier et sélectionnez Extraire tout pour ouvrir l’outil de décompression par défaut.
Une fois les fichiers décompressés, vous pouvez maintenant les visualiser. La plupart sont des fichiers texte que vous pouvez ouvrir avec le Bloc-notes ou tout autre éditeur de texte similaire.
¶ Téléchargez uniquement les fichiers nécessaires
Si vous ne souhaitez pas télécharger l’intégralité du projet, vous pouvez le faire :
- Allez sur le site Web du projet Urantiapedia sur GitHub : https://github.com/JanHerca/urantiapedia.
- Voici la page GitHub avec les fichiers. Vous pouvez vous déplacer dans les dossiers de la page GitHub. Lorsque vous avez besoin d’un fichier, entrez le fichier et cliquez sur le bouton Download raw file. Cela ouvrira la boîte de dialogue pour enregistrer chaque fichier.
De cette façon, vous pouvez choisir les fichiers que vous souhaitez télécharger, ce qui est une meilleure option si vous n’avez pas beaucoup d’espace libre sur votre disque dur ou si vous n’avez pas besoin de l’intégralité projet.
Nous pouvons maintenant éditer les fichiers dans un éditeur de texte.
¶ Editez les fichiers dans un éditeur de texte
Si vous apportez des corrections à des fichiers, vous n’avez pas besoin de modifier les fichiers originaux pour les envoyer par e-mail. Il suffit de copier un extrait d’un paragraphe que vous considérez comme incorrect et de souligner ce qui ne va pas et ce qui doit être vu.
Si ce que vous allez envoyer par courrier est une modification importante d’un ou plusieurs nouveaux fichiers, alors pour éditer ces fichiers, il est préférable d’utiliser un outil capable d’éditer des fichiers de type texte, une bonne recommandation est d’utiliser un logiciel capable d’afficher des fichiers cachés. caractères et espaces vides. Il est important de les afficher car ces caractères supplémentaires sont utilisés pour créer la structure des fichiers et si nous les supprimons nous pouvons endommager les fichiers.
Le logiciel le plus recommandé est Visual Studio Code, mais d’autres peuvent faire l’affaire :
- Le Notepad fourni par défaut avec Windows.
- Visual Studio Code : https://code.visualstudio.com/
- Notepad++ : https://notepad-plus-plus.org/
- Atom : https://atom.io/
- *Sublime * : https://www.sublimetext.com/
Tous sont gratuits.
Si vous utilisez Visual Studio Code voici quelques conseils utiles :
- Lors de l’installation, il est recommandé de cocher l’option Add action ‘Open with Code’ to folder context menu (Ajouter l’action ‘Ouvrir avec Code’ au menu contextuel du dossier) si vous êtes un utilisateur Windows. Cela ajoutera une option au menu contextuel des dossiers Windows afin que vous puissiez facilement ouvrir le contenu de n’importe quel dossier dans l’éditeur. De cette façon, si vous faites un clic droit sur le dossier urantiapedia, vous pouvez utiliser l’option Ouvrir le dossier pour ouvrir le projet directement dans VS Code.
- Une extension qui peut vous faciliter la vie est Sync Scroll. Cette extension permet de faire défiler plusieurs fichiers en parallèle, ce qui est très utile lors de l’édition dans plusieurs langues en même temps. Pour installer l’extension, accédez au panneau Extensions. Tapez Sync Scroll dans la zone de recherche. Cliquez sur le bouton Installer sur l’extension. Vous aurez maintenant un bouton dans la barre d’état pour activer ou désactiver Sync Scroll. Il est nécessaire d’avoir plusieurs fichiers ouverts en parallèle pour voir cette option. Pour ce faire, faites un clic droit sur un fichier ouvert dans la liste des fichiers et sélectionnez Ouvrir sur le côté.
¶ Envoi des modifications aux administrateurs
Envoyez simplement un email à urantiapedia@gmail avec les fichiers que vous avez modifiés ou que vous souhaitez ajouter. Dans le cas de fichiers à ajouter, indiquez dans le message électronique où ils doivent être ajoutés. S’il s’agit de simples corrections, vous pouvez également les ajouter au message électronique, il n’est pas nécessaire de les saisir dans un fichier.
Plus tard, les administrateurs prendront en charge ces envois et mettront à jour le site Web Urantiapedia avec les changements qu’ils jugeront corrects. Vous serez averti lorsque les modifications seront prêtes sur le site Web, ce qui peut facilement prendre quelques jours.
N’oubliez pas que si vous envoyez un e-mail sur le site Web, il ne sera pas indiqué que les modifications téléchargées ont été apportées par vous, mais qu’elles apparaîtront plutôt comme des modifications provenant des Administrateurs. Si vous voulez une preuve que vous avez apporté des modifications, vous devez utiliser la procédure Travailler directement depuis le site Web GitHub.
¶ Tâches
La liste des tâches et les manuels sur chaque tâche sont indiqués dans le manuel pour les administrateurs. L’index est le même que celui indiqué ici, alors consultez ce manuel pour plus de références.
¶ Liens externes
- Urantiapedia - Projet principal dans GitHub
- Urantiapedia-backup - Projet pour les chargements en masse dans GitHub
- Fondation Urantia
- Blue Fields
- Wiki.js