zag / js-pod6 Goto Github PK

Process L<> inside code blocks.
Example:
=code L<https://example.com>

process to
https://example.com

Delimited blocks inside code block Interpreted as blocks rather than raw text

=begin code
=begin item1
First
=end item1
=end code

Format as :

• First

Must as

=begin item1
First
=end item1

Error processing array pairs (with trailing spaces ):
=for code :as{ a=>1 }

Ok parse (without trailing spaces):
=for code :as{ a=>1}

I think an online Pod6 editor is a brilliant idea and has the potential to promote Pod6 a lot because of its approachability. (Opening a website has the lowest barrier of entry one can possibly have.) So this issue is mostly an encouragement to polish the https://pod6.in/ website more.

Here are just some ideas of what could be done:

• Give it a logo and a shiny page header
• Add an "About" button
• Link to the repo with a GitHub icon
• Add a link to https://docs.raku.org/language/pod
• Add a basic syntax documentation on the page itself
• Do some SEO so it pops up at the top when googling "pod6 editor" and "pod6 editor online"
• Add more expressive HTML highlighting (in the right column). Compare the a docs page with viewing the pod in pod6.in
• Add some POD highlighting (in the left column).
• Persist edited content (in a cookie?), so it's not lost on reload.

Formatting codes with empty content does not parsed
For example:

I empty Z<> 
B<>Options B<are>:

is rendered as text:

I empty Z<>
B<>Options are:

Thank you for creating https://pod6.in/ to render pod6 to html. That was very much needed tool.

I was trying to render this content

=head3 Rendering of rakudoc tables to html

=table
    Animal | Legs |    Eats
    =======================
    Zebra  +   4  + Cookies
    Human  +   2  +   Pizza
    Shark  +   0  +    Fish

=table
    X | O |
   ---+---+---
      | X | O
   ---+---+---
      |   | X

=table
    X   O
   ===========
        X   O
   ===========
            X

In the first table, the row content were all in single row. In the second and third tables, the column alignment was not clear.

I also tested the same with Pod::To::HTML which renders fine.

I think this could be improved in future releases.

1. formatting codes iinside =item not working
2. error detect numbering

=item I<#cdc> sdsdsd

Fail parse conf parameter with 3 and more elements: :allow<B Z I>

For example:

=for code :allow<B Z I>
This I<is> a B<text>

will fail at pod6.in

Thank you for writing this tool, which looks very useful! What is the license? The only reference I can find is "MIT", in package.json. Is that https://spdx.org/licenses/MIT.html? Thanks in advance for your response!

Fail process anchors in L<>
Example:
L<https://www.python.org/dev/peps/pep-0001/#what-is-a-pep>
not render as links.

Summary

I tried pod6.in. It didn't work. Details follow.

My system details

I'm using:
Firefox
Version 61.0.1
Build ID 20180712135629
User Agent Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:61.0) Gecko/20100101 Firefox/61.0
OS Linux 4.15.0-29-generic
Multiprocess Windows 1/1 (Enabled by default)
Web Content Processes 4/4
Enterprise Policies Inactive
Google Key Found
Mozilla Location Service Key Missing
Safe Mode false

What happened

When I arrived at pod6.in I saw a page with a title at the top (pod6 to html (0.0.17) and two panes.

On the left was pod:
=head1 Title
=head2 Subtitle
etc

On the right was:

There may have been an error. Check pod6 syntax at Synopsis 26 or please, fill issue here.

Technical details (please, attach this to issue):

TypeError: [].concat(...).flat is not a function

Parse content of A<identifier> with no spaces around identifier only.
Can't parse:

A<   identifier>
A<identifier   >
A<   identifier  >

It is ok for:
A<identifier>

For example:

=begin code
    =alias PROGNAME    Earl Irradiatem Eventually
    =alias VENDOR      4D Kingdoms
    =alias TERMS_URL   L<http://www.4dk.com/eie>
    The use of A<PROGNAME> is subject to the terms and conditions
    laid out by A<VENDOR>, as specified at A<TERMS_URL>.
=end code

Fail parse empty content for the ordered item

Example:
=item #

Error:
TypeError: Cannot read property 'hasOwnProperty' of undefined

This option specifies that the block is to be numbered
For example:

=for head2 :numbered
Subtitle