activemq-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Michael André Pearce <michael.andre.pea...@me.com>
Subject Re: Thoughts on refactoring the ActiveMQ website
Date Sat, 03 Feb 2018 17:30:17 GMT
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