activemq-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From François Papon <francois.pa...@openobject.fr>
Subject Re: Thoughts on refactoring the ActiveMQ website
Date Sun, 04 Feb 2018 06:31:52 GMT
Hi Mike,

+1 for me to be involved ;)

Ok for the week of 19th feb.

François

Le 3 févr. 2018 9:30 PM, Michael André Pearce <michael.andre.pearce@me.com> a écrit
:
>
> 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.pearce@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.pearce@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.snyder@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.pearce@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.snyder@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 <dkulp@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.snyder@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.snyder@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 <dkulp@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.snyder@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
<mtaylor@redhat.com> 
> >>>>>>>>> wrote: 
> >>>>>>>>>> 
> >>>>>>>>>>> On Wed, Dec 13, 2017 at 4:00 AM, Bruce Snyder
< 
> >>>>>> bruce.snyder@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.snyder@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 < 
> >>>>>> mtaylor@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.pearce@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.suconic@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 
> >>>>>>>>> dkulp@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 
> >>>>>> dkulp@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 
Mime
View raw message