Hi All, It’s been a bit quiet on the front of this effort.
I’d like to bump this a bit to get some feedback on the current examples, and try agree a plan going forwards and spread the work. I was speaking with Martyn the other week and we think maybe a brief webex to demo what’s been done so far and then discuss. Martyn’s offered he can host this using his bluejeans account (thanks) We are thinking of organising this for the week of 19th Feb. Any specific people who want to be involved can or cannot make? If not I’ll sync up with Martyn to agree and then post a time and date. Cheers Mike Sent from my iPhone > On 20 Dec 2017, at 01:26, Michael André Pearce <michael.andre.pea...@me.com> > wrote: > > Just FYI have sent a PR with a link to my branch of this export now in a > GitBook form still needs a lot of TLC but have tried to get a large bulk > done. To provide some skeleton for 5.x documents. > > > Sent from my iPhone > >> On 18 Dec 2017, at 20:26, Michael André Pearce <michael.andre.pea...@me.com> >> wrote: >> >> Yeah, unfortunately the tool i found wanted just html it blew up when trying >> to use modified. >> >> Like wise there was a couple of pages it couldn’t convert due to a css file >> on import issue but this wasn’t that many. >> >> Sent from my iPhone >> >>> On 18 Dec 2017, at 19:15, Bruce Snyder <bruce.sny...@gmail.com> wrote: >>> >>> Nice job, based on my spot check of a handful of files, it looks much >>> better. But we will still need to manually fix all the valid tables. >>> >>> Have you had a chance to look at the other branches that Dan Kulp provided? >>> >>> Bruce >>> >>> On Mon, Dec 18, 2017 at 10:59 AM, Michael André Pearce < >>> michael.andre.pea...@me.com> wrote: >>> >>>> I’ve had some luck auto generating MD files. >>>> >>>> Needs some cleanup which probably the worst can be bash scripted. >>>> >>>> Have sent a PR back to the activemq-web on github for others to see. >>>> >>>> Mike >>>> >>>> Sent from my iPhone >>>> >>>>> On 14 Dec 2017, at 16:31, Bruce Snyder <bruce.sny...@gmail.com> wrote: >>>>> >>>>> Thanks, Dan. So far I only see the body.storage branch (the others should >>>>> propagate in time). But I see that it's already more comprehensive than >>>> the >>>>> HTML that I pushed because it contains all the directories. We should >>>>> probably wipe out the master branch and choose one of yours as the new >>>>> master branch. >>>>> >>>>> Bruce >>>>> >>>>>> On Thu, Dec 14, 2017 at 7:56 AM, Daniel Kulp <dk...@apache.org> wrote: >>>>>> >>>>>> >>>>>> I hacked the Confluence exporter a bit to grab the page content in >>>>>> different formats so we can see if one is easier to migrate or >>>> similar. I >>>>>> just pushed 3 new branches to this repo: >>>>>> >>>>>> body.only - this is basically the same HTML, but with all the “wrapper” >>>>>> stuff removed. Just the HTML of the body content. So no navigation >>>> or >>>>>> header/footer, etc… >>>>>> >>>>>> body.storage - this is the raw storage format of the data from >>>>>> confluence. Things like code snippets are in storage format >>>>>> (<structured-macro name=“code” …>), etc. >>>>>> >>>>>> body.view - confluence has a “body.view” mode that is between the >>>>>> “storage” format and not really the exported HTML. The structured >>>>>> macros are expanded a bit (<script class=“brush: java”…), but not >>>> really in >>>>>> final HTML form either. >>>>>> >>>>>> >>>>>> Anyway, if interested in converting content, one of the above might be a >>>>>> better starting point. >>>>>> >>>>>> >>>>>> Dan >>>>>> >>>>>> >>>>>> >>>>>> >>>>>> >>>>>> >>>>>>> On Dec 13, 2017, at 4:49 PM, Bruce Snyder <bruce.sny...@gmail.com> >>>>>> wrote: >>>>>>> >>>>>>> The HTML is available in the repo now. This HTML is just what I grabbed >>>>>>> from the public directory. Even if it's not comprehensive, it's good >>>>>> enough >>>>>>> for hacking around to figure out what we'd like to do. >>>>>>> >>>>>>> In the meantime, I'm still working with ASF Infra to figure out why the >>>>>>> Confluence export is failing. >>>>>>> >>>>>>> Bruce >>>>>>> >>>>>>> On Wed, Dec 13, 2017 at 12:51 PM, Bruce Snyder <bruce.sny...@gmail.com >>>>> >>>>>>> wrote: >>>>>>> >>>>>>>> Yep, that is correct, Dan: >>>>>>>> >>>>>>>> https://git-wip-us.apache.org/repos/asf/activemq-web.git >>>>>>>> >>>>>>>> I pushed my changes to the repo. Now they just need to propagate to >>>> the >>>>>>>> Github web UI. >>>>>>>> >>>>>>>> Bruce >>>>>>>> >>>>>>>>> On Wed, Dec 13, 2017 at 11:28 AM, Daniel Kulp <dk...@apache.org> >>>> wrote: >>>>>>>>> >>>>>>>>> >>>>>>>>> Isn’t the push address supposed to be: >>>>>>>>> >>>>>>>>> https://git-wip-us.apache.org/repos/asf/activemq-web.git >>>>>>>>> >>>>>>>>> >>>>>>>>> Dan >>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>>> On Dec 13, 2017, at 1:15 PM, Bruce Snyder <bruce.sny...@gmail.com> >>>>>>>>> wrote: >>>>>>>>>> >>>>>>>>>> Thank you for the suggestion, but it looks like I do not have >>>>>>>>> permissions >>>>>>>>>> either. I will contact ASF Infra for assistance. >>>>>>>>>> >>>>>>>>>> Bruce >>>>>>>>>> >>>>>>>>>> On Wed, Dec 13, 2017 at 2:41 AM, Martyn Taylor <mtay...@redhat.com> >>>>>>>>> wrote: >>>>>>>>>> >>>>>>>>>>> On Wed, Dec 13, 2017 at 4:00 AM, Bruce Snyder < >>>>>> bruce.sny...@gmail.com> >>>>>>>>>>> wrote: >>>>>>>>>>> >>>>>>>>>>>> I had the following empty git repo created to hold the HTML from >>>> the >>>>>>>>>>>> current website: >>>>>>>>>>>> >>>>>>>>>>>> https://github.com/apache/activemq-web >>>>>>>>>>>> >>>>>>>>>>>> However, I have a conundrum -- content cannot be pushed directly >>>> to >>>>>> a >>>>>>>>>>>> Github ASF repo. Content can only be added via pull request but >>>>>> Github >>>>>>>>>>> does >>>>>>>>>>>> not allow a pull request on an empty repo. >>>>>>>>>>>> >>>>>>>>>>> Bruce, have you tried pushing directly to the ASF repo. i.e. >>>> git:// >>>>>>>>>>> git.apache.org/activemq-web.git >>>>>>>>>>> >>>>>>>>>>> This is the workflow we currently use, we push directly to the ASF >>>>>>>>> repo. >>>>>>>>>>> PRs are really only used for review and discussion. I tried to >>>> push >>>>>>>>>>> directly this morning but looks like I don't have write >>>> permissions. >>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> Any ideas on how to get the HTML into the repo? I guess I could >>>> ask >>>>>>>>> ASF >>>>>>>>>>>> Infra to push it. >>>>>>>>>>>> >>>>>>>>>>>> Bruce >>>>>>>>>>>> >>>>>>>>>>>> On Tue, Dec 12, 2017 at 8:17 PM, Bruce Snyder < >>>>>> bruce.sny...@gmail.com >>>>>>>>>> >>>>>>>>>>>> wrote: >>>>>>>>>>>> >>>>>>>>>>>>> I'm going to address all the questions to me in this single >>>> reply. >>>>>>>>>>>>> >>>>>>>>>>>>> My original suggestion was that we export the HTML from >>>> Confluence, >>>>>>>>>>>>> convert to Markdown and put the Markdown and the images in a git >>>>>>>>> repo. >>>>>>>>>>>>> Markdown is much easier to edit than raw HTML, especially the >>>> HTML >>>>>>>>>>>> exported >>>>>>>>>>>>> from Confluence (blech!). The idea was that we could use Jekyll + >>>>>>>>> SAAS >>>>>>>>>>> to >>>>>>>>>>>>> craft a new website. In fact, Michael Andre Pearce produced a >>>>>> mockup >>>>>>>>> of >>>>>>>>>>>>> this using the Apache Metro website as an example (because it >>>>>> already >>>>>>>>>>>> makes >>>>>>>>>>>>> use of Jekyll + SAAS). It was enough to convince me that we >>>> should >>>>>>>>> take >>>>>>>>>>>>> this path, so I started looking into doing a full, new export of >>>>>>>>>>>> Confluence >>>>>>>>>>>>> pages to HTML. If you have not seen Michael's mockup, you should >>>>>>>>> really >>>>>>>>>>>>> take a look. >>>>>>>>>>>>> >>>>>>>>>>>>> So, I manually grabbed the raw HTML that is automagically >>>> exported >>>>>>>>> from >>>>>>>>>>>>> Confluence and is hosting the current site that we see at >>>>>>>>>>>>> http://activemq.apache.org. I did some testing on it using >>>>>> text2html >>>>>>>>>>> and >>>>>>>>>>>>> the conversion it does is pretty awful and would require a lot of >>>>>>>>> hand >>>>>>>>>>>> work >>>>>>>>>>>>> to fix it. So, we discussed the point that there are 1600+ pages >>>> of >>>>>>>>>>> HTML >>>>>>>>>>>> to >>>>>>>>>>>>> manually edit. But I later realized that it was only about 950 >>>> HTML >>>>>>>>>>> pages >>>>>>>>>>>>> (from what I can tell so far). >>>>>>>>>>>>> >>>>>>>>>>>>> Then, Dan Kulp found a Confluence HTML to raw HTML converter >>>> built >>>>>> on >>>>>>>>>>> top >>>>>>>>>>>>> of PanDoc. So, I have also been trying to export the HTML from >>>>>>>>>>> Confluence >>>>>>>>>>>>> in order to try out the PanDoc converter (it works based on the >>>>>>>>>>>> Confluence >>>>>>>>>>>>> export function which is different from how the HTML is >>>>>> automagically >>>>>>>>>>>>> converted). Unfortunately, I am running into a >>>> NullPointerException >>>>>>>>>>> from >>>>>>>>>>>>> Confluence. ASF Infra is telling me that the NPE is due to the >>>>>> CDATA >>>>>>>>> in >>>>>>>>>>>> the >>>>>>>>>>>>> search function on the Navigation page and is suggesting that the >>>>>>>>>>>> solution >>>>>>>>>>>>> is to remove the Navigation page. The problem with this >>>> suggestion >>>>>> is >>>>>>>>>>>> that >>>>>>>>>>>>> it would fundamentally remove all the navigation on the >>>> right-hand >>>>>>>>> side >>>>>>>>>>>> of >>>>>>>>>>>>> the site -- not what we want. >>>>>>>>>>>>> >>>>>>>>>>>>> I have also given some thought to the idea that removing the >>>>>> current >>>>>>>>>>> site >>>>>>>>>>>>> will break all links to old site. This is something that cannot >>>> be >>>>>>>>>>>>> overlooked and must be prevented as we do not want to leave users >>>>>> who >>>>>>>>>>>> have >>>>>>>>>>>>> bookmarked a page high and dry. This is a fairly easy problem to >>>>>>>>> solve >>>>>>>>>>>> this >>>>>>>>>>>>> using some mod_rewrite rules, the question is if ASF Infra is >>>>>> willing >>>>>>>>>>> to >>>>>>>>>>>>> allow us to deploy such custom rules. This should be investigated >>>>>>>>> when >>>>>>>>>>> we >>>>>>>>>>>>> get to that point, but we are not there yet. First, we need to >>>>>> decide >>>>>>>>>>> the >>>>>>>>>>>>> best path forward based on what I have described above in the >>>>>>>>> preceding >>>>>>>>>>>>> paragraphs. >>>>>>>>>>>>> >>>>>>>>>>>>> >>>>>>>>>>>>> Bruce >>>>>>>>>>>>> >>>>>>>>>>>>> On Tue, Dec 12, 2017 at 11:39 AM, Martyn Taylor < >>>>>> mtay...@redhat.com> >>>>>>>>>>>>> wrote: >>>>>>>>>>>>> >>>>>>>>>>>>>> I was thinking there would be a single css file for all the >>>> pages. >>>>>>>>>>> But >>>>>>>>>>>> I >>>>>>>>>>>>>> haven't seen the files yet. Let's have a play around when Bruce >>>>>>>>> pushes >>>>>>>>>>>> the >>>>>>>>>>>>>> export. >>>>>>>>>>>>>> >>>>>>>>>>>>>> Cheers >>>>>>>>>>>>>> >>>>>>>>>>>>>> On 12 Dec 2017 5:30 pm, "Michael André Pearce" < >>>>>>>>>>>>>> michael.andre.pea...@me.com> >>>>>>>>>>>>>> wrote: >>>>>>>>>>>>>> >>>>>>>>>>>>>>> What’s 1600 pages between friends.... >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> I agree it will be easier to covert to md than to start doing >>>> css >>>>>>>>>>>>>> styles. >>>>>>>>>>>>>>> It’s all from a wiki anyhow so it’s can’t be that far off. >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> It be good to get some samples (eg 50 pages) if not all just to >>>>>> try >>>>>>>>>>>> and >>>>>>>>>>>>>>> see what it is like. >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> >>>>>>>>>>>>>>> On 12 Dec 2017, at 17:04, Clebert Suconic < >>>>>>>>>>> clebert.suco...@gmail.com> >>>>>>>>>>>>>>> wrote: >>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> Exporting to MD and creating a gitbook seems like a big >>>> task, I >>>>>>>>>>>>>> suspect >>>>>>>>>>>>>>> any >>>>>>>>>>>>>>>>> tool we use will cause a bunch of styling/content issues. >>>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>>> At least initially, how about we just create a nice landing >>>>>> page >>>>>>>>>>>> that >>>>>>>>>>>>>>>>> brings the ActiveMQ site and Artemis site together, and >>>>>>>>>>>> refresh/align >>>>>>>>>>>>>>> the >>>>>>>>>>>>>>>>> existing content with some CSS? >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> I was just looking for the minimal effort task. I thought that >>>>>>>>>>>>>>>> converting these pages into a doc would be easier than >>>>>> converting >>>>>>>>>>>> them >>>>>>>>>>>>>>>> to another .css... >>>>>>>>>>>>>>>> >>>>>>>>>>>>>>>> if the conversion needed to be done anyways... I thought .md >>>>>> would >>>>>>>>>>>> be >>>>>>>>>>>>>>>> easier and having a better final presentation. >>>>>>>>>>>>>>> >>>>>>>>>>>>>> >>>>>>>>>>>>> >>>>>>>>>>>>> >>>>>>>>>>>>> >>>>>>>>>>>>> -- >>>>>>>>>>>>> perl -e 'print unpack("u30","D0G)U8V4\@4VYY9& >>>>>>>>>>>>> 5R\"F)R=6-E+G-N>61E<D\!G;6%I;\"YC;VT*" );' >>>>>>>>>>>>> >>>>>>>>>>>>> ActiveMQ in Action: http://bit.ly/2je6cQ >>>>>>>>>>>>> Blog: http://bsnyder.org/ <http://bruceblog.org/> >>>>>>>>>>>>> Twitter: http://twitter.com/brucesnyder >>>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> -- >>>>>>>>>>>> perl -e 'print >>>>>>>>>>>> unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=6-E+G-N>61E<D\!G;6%I;\ >>>>>> "YC;VT*" >>>>>>>>> );' >>>>>>>>>>>> >>>>>>>>>>>> ActiveMQ in Action: http://bit.ly/2je6cQ >>>>>>>>>>>> Blog: http://bsnyder.org/ <http://bruceblog.org/> >>>>>>>>>>>> Twitter: http://twitter.com/brucesnyder >>>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> -- >>>>>>>>>> perl -e 'print >>>>>>>>>> unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=6-E+G-N>61E<D\!G;6%I;\ >>>> "YC;VT*" >>>>>>>>> );' >>>>>>>>>> >>>>>>>>>> ActiveMQ in Action: http://bit.ly/2je6cQ >>>>>>>>>> Blog: http://bsnyder.org/ <http://bruceblog.org/> >>>>>>>>>> Twitter: http://twitter.com/brucesnyder >>>>>>>>> >>>>>>>>> -- >>>>>>>>> Daniel Kulp >>>>>>>>> dk...@apache.org - http://dankulp.com/blog >>>>>>>>> Talend Community Coder - http://coders.talend.com >>>>>>>>> >>>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> -- >>>>>>>> perl -e 'print unpack("u30","D0G)U8V4\@4VYY9& >>>>>>>> 5R\"F)R=6-E+G-N>61E<D\!G;6%I;\"YC;VT*" );' >>>>>>>> >>>>>>>> ActiveMQ in Action: http://bit.ly/2je6cQ >>>>>>>> Blog: http://bsnyder.org/ <http://bruceblog.org/> >>>>>>>> Twitter: http://twitter.com/brucesnyder >>>>>>>> >>>>>>> >>>>>>> >>>>>>> >>>>>>> -- >>>>>>> perl -e 'print >>>>>>> unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=6-E+G-N>61E<D\!G;6%I;\"YC;VT*" >>>> );' >>>>>>> >>>>>>> ActiveMQ in Action: http://bit.ly/2je6cQ >>>>>>> Blog: http://bsnyder.org/ <http://bruceblog.org/> >>>>>>> Twitter: http://twitter.com/brucesnyder >>>>>> >>>>>> -- >>>>>> Daniel Kulp >>>>>> dk...@apache.org - http://dankulp.com/blog >>>>>> Talend Community Coder - http://coders.talend.com >>>>>> >>>>>> >>>>> >>>>> >>>>> -- >>>>> perl -e 'print >>>>> unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=6-E+G-N>61E<D\!G;6%I;\"YC;VT*" );' >>>>> >>>>> ActiveMQ in Action: http://bit.ly/2je6cQ >>>>> Blog: http://bsnyder.org/ <http://bruceblog.org/> >>>>> Twitter: http://twitter.com/brucesnyder >>>> >>> >>> >>> >>> -- >>> perl -e 'print >>> unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=6-E+G-N>61E<D\!G;6%I;\"YC;VT*" );' >>> >>> ActiveMQ in Action: http://bit.ly/2je6cQ >>> Blog: http://bsnyder.org/ <http://bruceblog.org/> >>> Twitter: http://twitter.com/brucesnyder
