activemq-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Bruce Snyder <bruce.sny...@gmail.com>
Subject Re: Thoughts on refactoring the ActiveMQ website
Date Mon, 18 Dec 2017 19:15:20 GMT
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
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message