On Sat, 3 May 2025 at 00:05, sebb <seb...@gmail.com> wrote:
> On Fri, 2 May 2025 at 23:49, Niall Pemberton <niall.pember...@gmail.com>
> wrote:
> >
> > On Fri, 2 May 2025 at 18:52, sebb <seb...@gmail.com> wrote:
> >
> > > On Fri, 2 May 2025 at 17:11, Niall Pemberton <
> niall.pember...@gmail.com>
> > > wrote:
> > > >
> > > > On Fri, 2 May 2025 at 09:49, sebb <seb...@gmail.com> wrote:
> > > >
> > > > > Markdown is easy to use for most things, except wide tables, as
> rows
> > > > > cannot be broken across lines.
> > > > >
> > > >
> > > > It can be done - I've just simplified the table in projects.md and
> split
> > > it
> > > > over two lines. In this case I used the Liquid {%- link %} tag to
> remove
> > > > preceding whitespace (the "-" after the "%" does that).
> > >
> > > The table that caused me a problem is here:
> > >
> > >
> > >
> https://github.com/apache/attic/blob/983591a2e05073cab906c1cf94e627d5c1498fde/data.md?plain=1#L73
> > >
> > > Can that be simplified?
> > >
> >
> > I've split some of the lines in that table:
> >
> >
> https://github.com/apache/attic/commit/af451d42e553184c5261c19e787b5d0c77bdcfcf
>
> That makes it easier to read the source, but unfortunately the preview
> is mangled, which makes it harder to check local edits.
>
Well with Jekyll & Liquid its always going to screw up plain markdown
preview. Its risky to rely on preview of vanilla markdown when thats not
what the site is. Better to serve it through Jekyll, since it needs to be
checked before committing anyway and with live reload, that makes it easy
Niall
>
> > Niall
> >
> >
> >
> > >
> > > > However, without the need for that link tag, then with Liquid 4.x
> (which
> > > > Jekyll is locked to) its a hack. Would be easier in Liquid 5.x using
> the
> > > {%
> > > > echo %} tag, but Jekyll is currently incompatible with 5.x.
> > > >
> > > > I might add a custom "does nothing" tag, to make this easier.
> > > >
> > > > So I don't think we need to add another format for content.
> > > >
> > > > Niall
> > > >
> > > >
> > > >
> > > > >
> > > > > Asciidoc allows table rows to be split across lines, for example:
> > > > >
> > > > >
> > > > >
> > >
> https://github.com/apache/commons-parent/blob/master/COMPONENTS.adoc?plain=1
> > > > >
> > > > > Compare that with the previous MD version:
> > > > >
> > > > >
> > > > >
> > >
> https://github.com/apache/commons-parent/blob/997a7bd3e045ad1651ec4ac9788a66dc3f1b751e/COMPONENTS.md?plain=1
> > > > >
> > > > > AFAICT it should be easy enough to enable asciidoc.
> > > > >
> > > > > Sebb
> > > > >
> > >
>
