Mailing-List: contact allura-dev-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: allura-dev@incubator.apache.org
Received-SPF: pass (nike.apache.org: domain of noreply@sourceforge.net
 designates 216.34.181.60 as permitted sender)
Content-Type: multipart/related;
 boundary="===============5205457434409705701=="
MIME-Version: 1.0
To: "[allura:tickets] " <6534@tickets.allura.p.re.sf.net>
From: "Dave Brondsema" <brondsem@users.sf.net>
Reply-To: "[allura:tickets] " <6534@tickets.allura.p.re.sf.net>
Subject: [allura:tickets] #6534 Wiki importer for github
Message-ID: 
 </p/allura/tickets/6534/f89ee455b39881620a4734d1047414b3a73f86c7.tickets@allura.p.sourceforge.net>
Date: Fri, 04 Oct 2013 14:43:00 +0000

--===============5205457434409705701==
Content-Type: multipart/alternative;
 boundary="===============8903369086823257698=="
MIME-Version: 1.0

--===============8903369086823257698==
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit

Merged je/42cc_6534 to master.


---

** [tickets:#6534] Wiki importer for github**

**Status:** code-review
**Labels:** import github 42cc 
**Created:** Wed Aug 07, 2013 09:54 PM UTC by Dave Brondsema
**Last Updated:** Wed Oct 02, 2013 08:59 AM UTC
**Owner:** nobody

Wikis are git repositories and can be accessed like `git clone https://github.com/OpenRefine/OpenRefine.wiki` for example.  Check the main repo API first to see if the repo has wiki enabled.  You can see https://sourceforge.net/p/googlecodewikiimporter/git/ for reference as an example of another wiki importer.  It is a separate repo because it needs the "html2text" package to convert html to markdown, and that is a GPL library.

Github supports many markup types.  Find a full list and determine what the best way to convert them to markdown is.  My guess is that few formats will have tools available to convert them directly to markdown, so my likely recommendation would be to render them as HTML (using [pypeline](http://pypeline.sourceforge.net/) as a generic way to handle many of those formats) and then html2text to get it into markdown.

If html2text or any other GPL library is needed, this will have to be a separate repo from the main Allura repo.  So please evaluate & test the conversion options first, before putting code into place.

A second phase to all this (i.e. do it separately, after the basic import is all working) would be to handle revision history.  This would mean going through each commit in the wiki git repo, and converting & updating every file that changes.  This may be very time consuming, so when we get to it, we may want it to be a checkbox option, so users only do it if they want it.


---

Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to https://sourceforge.net/p/allura/tickets/

To unsubscribe from further messages, a project admin can change settings at https://sourceforge.net/p/allura/admin/tickets/options.  Or, if this is a mailing list, you can unsubscribe from the mailing list.
--===============8903369086823257698==
MIME-Version: 1.0
Content-Type: text/html; charset="us-ascii"
Content-Transfer-Encoding: 7bit

<div class="markdown_content"><p>Merged je/42cc_6534 to master.</p>
<hr />
<p><strong> <a class="alink" href="http://sourceforge.net/p/allura/tickets/6534/">[tickets:#6534]</a> Wiki importer for github</strong></p>
<p><strong>Status:</strong> code-review<br />
<strong>Labels:</strong> import github 42cc <br />
<strong>Created:</strong> Wed Aug 07, 2013 09:54 PM UTC by Dave Brondsema<br />
<strong>Last Updated:</strong> Wed Oct 02, 2013 08:59 AM UTC<br />
<strong>Owner:</strong> nobody</p>
<p>Wikis are git repositories and can be accessed like <code>git clone https://github.com/OpenRefine/OpenRefine.wiki</code> for example.  Check the main repo API first to see if the repo has wiki enabled.  You can see <a href="https://sourceforge.net/p/googlecodewikiimporter/git/">https://sourceforge.net/p/googlecodewikiimporter/git/</a> for reference as an example of another wiki importer.  It is a separate repo because it needs the "html2text" package to convert html to markdown, and that is a GPL library.</p>
<p>Github supports many markup types.  Find a full list and determine what the best way to convert them to markdown is.  My guess is that few formats will have tools available to convert them directly to markdown, so my likely recommendation would be to render them as HTML (using <a class="" href="http://pypeline.sourceforge.net/">pypeline</a> as a generic way to handle many of those formats) and then html2text to get it into markdown.</p>
<p>If html2text or any other GPL library is needed, this will have to be a separate repo from the main Allura repo.  So please evaluate &amp; test the conversion options first, before putting code into place.</p>
<p>A second phase to all this (i.e. do it separately, after the basic import is all working) would be to handle revision history.  This would mean going through each commit in the wiki git repo, and converting &amp; updating every file that changes.  This may be very time consuming, so when we get to it, we may want it to be a checkbox option, so users only do it if they want it.</p>
<hr />
<p>Sent from sourceforge.net because allura-dev@incubator.apache.org is subscribed to <a href="https://sourceforge.net/p/allura/tickets/">https://sourceforge.net/p/allura/tickets/</a></p>
<p>To unsubscribe from further messages, a project admin can change settings at <a href="https://sourceforge.net/p/allura/admin/tickets/options.">https://sourceforge.net/p/allura/admin/tickets/options.</a>  Or, if this is a mailing list, you can unsubscribe from the mailing list.</p></div>
--===============8903369086823257698==--

--===============5205457434409705701==--