Mailing-List: contact dev-help@activemq.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@activemq.apache.org
MIME-Version: 1.0
In-Reply-To: <DFEB5101-A39C-4606-AAA1-4771D18CBBF7@me.com>
References: <CAMgYm0wsbLvbv8jhOXdCAYpq7q=VfEkHm9Q9iJxgpg7nnwUObg@mail.gmail.com>
 <CAKF+bsr3cyz6veqNiwNwExJhxw9wu0v2J2n=g_ezRH0iFnAqXQ@mail.gmail.com>
 <CAMgYm0zMK1783EF9AHqgmsW=vJoj=yDkW055pEs=DgO41GTYCQ@mail.gmail.com>
 <0FBF9563-DA24-4FB8-BBBC-84EDDF31849F@me.com> <CAMgYm0x3QTKtf24keauTJ+F3bh1Kas2cEDYu0wSjTtAZUBWV3A@mail.gmail.com>
 <CAH6wpnqdHwGsA5Aend4rZMpaMCEF_qcZYaEzz-Y3wa6aDcqhsg@mail.gmail.com>
 <CAMgYm0xDnYbKGPFRkYoo0O6dcb6W2Cajtwk27BXbd-pqw2uH5g@mail.gmail.com>
 <CAH6wpnpv5S2DCMakj7ndrTiZd9zGpUqZW3TxmLKsxL+hTK6i4g@mail.gmail.com>
 <CAKF+bsqhQqS=2fu9AsTGdAN9OUd_bdtmx_1-Pe4kB5f4dB9pdA@mail.gmail.com>
 <37622EC4-A74D-4C1C-8887-A15BEDC37F9D@me.com> <CAH6wpnrE78KLX3hKjTQ1ihOYjNS1-DXmOkW6irf-F4JeEww1pg@mail.gmail.com>
 <CAKF+bsoFtvR=xtQLFZT6FJhbPmJHzcmUAJXae_1nbKdonttVug@mail.gmail.com>
 <9ADB6FD8-1E93-4570-980E-9E3881423190@me.com> <CAH6wpnpiqQeandsS8KX2hHe3S6DduJjog-jTfrbpiofg_Yu0WQ@mail.gmail.com>
 <CAMgYm0z_mion8_3tr7t2yyKnK0NxewNd=YSCFFO1kab8o4-wAg@mail.gmail.com>
 <CAMgYm0zBW+_sdAYUUfFainYxKD6iuzjGWxQg=gEPAQf22dv38Q@mail.gmail.com>
 <CAH6wpnp86PQ75hT1EdzbGQ3Jo30bUxmMsM7dayugnXbo3_ZpAw@mail.gmail.com>
 <CAMgYm0wT+vGoWgEkuEkDwttf5fcrEL3+Wob9wvfH=SiOO7Mqug@mail.gmail.com>
 <5BDE5E12-EE74-4B6A-940C-7F2CA88D91C0@apache.org> <CAMgYm0wHZ2inntJ0fTOaXbBENuFCGDVJbaqwhxx8k7OZa6keRA@mail.gmail.com>
 <CAMgYm0zYpOiEQANhG1N+EVVDN2OzbL0gYBPhjOmijOkkgrqFTA@mail.gmail.com>
 <0F0B84D1-251C-47A8-94B6-4CC35D43BD7A@apache.org> <CAMgYm0wau3EzB+Va47kvh7fj0ofPV_NAivZDtW=1ydkRMCKBtQ@mail.gmail.com>
 <DFEB5101-A39C-4606-AAA1-4771D18CBBF7@me.com>
From: Bruce Snyder <bruce.snyder@gmail.com>
Date: Mon, 18 Dec 2017 12:15:20 -0700
Message-ID: <CAMgYm0zn-+XzZTq8R9xAn5+fbzrLTiGQyJp=Eq+vRH-Cn72VAA@mail.gmail.com>
Subject: Re: Thoughts on refactoring the ActiveMQ website
To: dev@activemq.apache.org
Content-Type: multipart/alternative; boundary="089e08232140f3583a0560a22ba3"
archived-at: Mon, 18 Dec 2017 19:15:38 -0000

--089e08232140f3583a0560a22ba3
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

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=C3=A9 Pearce <
michael.andre.pearce@me.com> wrote:

> I=E2=80=99ve 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 shou=
ld
> > 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 =E2=80=
=9Cwrapper=E2=80=9D
> >> stuff removed.   Just the HTML of the body content.   So no navigation
> or
> >> header/footer, etc=E2=80=A6
> >>
> >> body.storage - this is the raw storage format of the data from
> >> confluence.   Things like code snippets are in storage format
> >> (<structured-macro name=3D=E2=80=9Ccode=E2=80=9D =E2=80=A6>), etc.
> >>
> >> body.view - confluence has a =E2=80=9Cbody.view=E2=80=9D mode that is =
between the
> >> =E2=80=9Cstorage=E2=80=9D format and not really the exported HTML.    =
 The structured
> >> macros are expanded a bit (<script class=3D=E2=80=9Cbrush: java=E2=80=
=9D=E2=80=A6), 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 grabb=
ed
> >>> 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 t=
he
> >>> Confluence export is failing.
> >>>
> >>> Bruce
> >>>
> >>> On Wed, Dec 13, 2017 at 12:51 PM, Bruce Snyder <bruce.snyder@gmail.co=
m
> >
> >>> 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=E2=80=99t 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 AS=
F
> >>>>> 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 gi=
t
> >>>>> 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 o=
f
> >>>>>>>> Confluence
> >>>>>>>>> pages to HTML. If you have not seen Michael's mockup, you shoul=
d
> >>>>> 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+ page=
s
> 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 t=
he
> >>>>>>>> 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 use=
rs
> >> who
> >>>>>>>> have
> >>>>>>>>> bookmarked a page high and dry. This is a fairly easy problem t=
o
> >>>>> 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 investigat=
ed
> >>>>> 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 Bruc=
e
> >>>>> pushes
> >>>>>>>> the
> >>>>>>>>>> export.
> >>>>>>>>>>
> >>>>>>>>>> Cheers
> >>>>>>>>>>
> >>>>>>>>>> On 12 Dec 2017 5:30 pm, "Michael Andr=C3=A9 Pearce" <
> >>>>>>>>>> michael.andre.pearce@me.com>
> >>>>>>>>>> wrote:
> >>>>>>>>>>
> >>>>>>>>>>> What=E2=80=99s 1600 pages between friends....
> >>>>>>>>>>>
> >>>>>>>>>>> I agree it will be easier to covert to md than to start doing
> css
> >>>>>>>>>> styles.
> >>>>>>>>>>> It=E2=80=99s all from a wiki anyhow so it=E2=80=99s can=E2=80=
=99t 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 th=
at
> >>>>>>>>>>>> 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=3D6-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=3D6-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=3D6-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=3D6-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=3D6-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=3D6-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
>


--=20
perl -e 'print
unpack("u30","D0G)U8V4\@4VYY9&5R\"F)R=3D6-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

--089e08232140f3583a0560a22ba3--