applicationUI to import GitHub pages into wiki pages
TypeXAR
Category
Developed by

Hassan Ali

Active Installs1
Rating
0 Votes
LicenseGNU Lesser General Public License 2.1

Installable with the Extension Manager

Description

A User-friendly Interface to import GitHub pages as wiki pages into XWiki using GitHub Importer Filter.

Usage

  1. Open GitHub Importer from the Applications Panel.

    GithubImporterUIx1.png

  2. Fill the fields with your values.
    • Source Type: The source can be a URL (online) or a File (offline) types.
    • URL: Link (URL) to the GitHub pages/wiki repository to import. This need internet connection.

      Some interesting GitHub pages/wiki examples that you could try out:

    • Path (in case of File/Directory): The path/reference to the file (zip) or directory (an already cloned repository) in your storage.
    • 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.
  3. Click the Import button.

    GithubImporterUIx2.png

    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:

  1. Log in the wiki with a user having Administration rights
  2. Go to the Administration page and select the Import category
  3. Follow the on-screen instructions to upload the downloaded XAR
  4. Click on the uploaded XAR and follow the instructions
  5. 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):

Tags:
    

Get Connected