+1 Bruce
On Sat, Feb 3, 2018 at 10:30 AM, Michael André Pearce < michael.andre.pea...@me.com> wrote: > 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 > -- 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
