GitHub Importer Application
UI to import GitHub pages into wiki pages |
Type | XAR |
Category | |
Developed by | |
Active Installs | 1 |
Rating | |
License | GNU Lesser General Public License 2.1 |
Table of contents
Description
A User-friendly Interface to import GitHub pages as wiki pages into XWiki using GitHub Importer Filter.
Usage
- Open GitHub Importer from the Applications Panel.
- Fill the fields with your values.
- Source: Link to the GitHub pages/wiki repository to import.
Some interesting GitHub pages/wiki examples that you could try out:
- GitHub Wikis
- Nebulasio wiki. Use the https://github.com/nebulasio/wiki.wiki.git value for the source.
- MIXXXDJ wiki. Use the https://github.com/mixxxdj/mixxx.wiki.git value for the source.
- GitHub Pages
- Kbroman's simple github pages website. Use the https://github.com/kbroman/simple_site.git value for the source.
- Open Tech School github pages website. Use the https://github.com/OpenTechSchool/www.opentechschool.org.git value for the source.
- beta.gouv.fr. Use the https://github.com/betagouv/beta.gouv.fr.git value for the source.
- GitHub Wikis
- Parent Page: The root of the pages to be imported, to keep them in a defined space.
- Authentication Code: The token / oauth / password of the GitHub user to clone protected repositories.
- Username: The username of the GitHub user (Only needed if you are using the Authentication Code with Password).
- Convert Syntax: Whether to convert the GitHub pages written in GitHub-flavored Markdown syntax into XWiki Syntax 2.1 (xwiki/2.1) or not. If not checked, then the content is not converted and the page is set to use the Markdown Syntax 1.2 (markdown/1.2).
- Create Hierarchy of Pages: Imports and saves the pages hierarchically in XWiki according to their level defined in Sidebar (_Sidebar.md) since GitHub do not support hierarchy.
- Source: Link to the GitHub pages/wiki repository to import.
- Click the Import button.Wait for the import to finish. If the import fails, check the Job log to see where the error occurs from.
If the import is successful, new pages will be created in your XWiki. Click on the Job log and check where the pages have been created. In case you can not see them, reload the page and make sure you are looking for the parent page.
Prerequisites & Installation Instructions
We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager). Note that installing Extensions when being offline is currently not supported and you'd need to use some complex manual method.
You can also use the following manual method, which is useful if this extension cannot be installed with the Extension Manager or if you're using an old version of XWiki that doesn't have the Extension Manager:
- Log in the wiki with a user having Administration rights
- Go to the Administration page and select the Import category
- Follow the on-screen instructions to upload the downloaded XAR
- Click on the uploaded XAR and follow the instructions
- You'll also need to install all dependent Extensions that are not already installed in your wiki
Release Notes
v1.4
v1.3
v1.2
v1.1
Dependencies
Dependencies for this extension (org.xwiki.contrib.github-importer:github-importer-ui 1.4):
- org.xwiki.contrib.github-importer:github-importer-filter 1.4
- org.xwiki.platform:xwiki-platform-filter-script 12.4
- org.xwiki.platform:xwiki-platform-rendering-macro-velocity 12.4
- org.xwiki.platform:xwiki-platform-rendering-macro-include 12.4
- org.xwiki.rendering:xwiki-rendering-macro-html 12.4
- org.xwiki.platform:xwiki-platform-panels-ui 12.4