Pikchr in Pandoc

Pikchr in Pandoc

[Dan Shearer]

I have not noticed mention of Pikchr here, and I think it is relevant to
recent discussion of diagrams and also GSoC.

https://pikchr.org/ is a simple plain-text markup language for diagrams
that produces SVG. It is a slightly modified version of Brian
Kernighan's PIC language from 40 years ago, updated to make it safe to
use on the web.

Pikchr is ideal for use in Markdown - see the examples at 
https://pikchr.org/home/skn_default/doc/trunk/doc/examples.md , or the 
same examples in darkmode:
https://pikchr.org/home/skn_ardoise/doc/trunk/doc/examples.md . Click on
each diagram to see the plain text source code.

Pikchr is implemented in a single C source file with no dependencies,
intended for embedding within as many tools as possible. 

--
Dan Shearer
dan-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org

Re: Pikchr in Pandoc

[ChrisD]

I was not aware of Pitchr, so thanks for posting this. I have used dot (graphviz) a lot, but Pitchr looks to fill a different niche.

Is Pitchr available as a executable somewhere? All I could find was the C source code file. Thanks,


On 1/31/2021 9:42 PM, Dan Shearer wrote:
> I have not noticed mention of Pikchr here, and I think it is relevant to
> recent discussion of diagrams and also GSoC.
>
> https://pikchr.org/ is a simple plain-text markup language for diagrams
> that produces SVG. It is a slightly modified version of Brian
> Kernighan's PIC language from 40 years ago, updated to make it safe to
> use on the web.
>
> Pikchr is ideal for use in Markdown - see the examples at
> https://pikchr.org/home/skn_default/doc/trunk/doc/examples.md , or the
> same examples in darkmode:
> https://pikchr.org/home/skn_ardoise/doc/trunk/doc/examples.md . Click on
> each diagram to see the plain text source code.
>
> Pikchr is implemented in a single C source file with no dependencies,
> intended for embedding within as many tools as possible.
>
> --
> Dan Shearer
> dan-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org
>

Re: Pikchr in Pandoc

[John MacFarlane]

We wouldn't embed this directly in pandoc (trying to avoid
C dependencies), but it would be easy to create a filter
to intercept specially marked code blocks and convert them
to pictures. (There are examples of this kind of thing in the
pandoc/lua-filters repository.)

Dan Shearer <dan-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org> writes:

> I have not noticed mention of Pikchr here, and I think it is relevant to
> recent discussion of diagrams and also GSoC.
>
> https://pikchr.org/ is a simple plain-text markup language for diagrams
> that produces SVG. It is a slightly modified version of Brian
> Kernighan's PIC language from 40 years ago, updated to make it safe to
> use on the web.
>
> Pikchr is ideal for use in Markdown - see the examples at 
> https://pikchr.org/home/skn_default/doc/trunk/doc/examples.md , or the 
> same examples in darkmode:
> https://pikchr.org/home/skn_ardoise/doc/trunk/doc/examples.md . Click on
> each diagram to see the plain text source code.
>
> Pikchr is implemented in a single C source file with no dependencies,
> intended for embedding within as many tools as possible. 
>
> --
> Dan Shearer
> dan-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org
>
> -- 
> You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/YBeGoc/cMhn7sLG8%40mx.shearer.org.

Re: Pikchr in Pandoc

['Dan Shearer' via pandoc-discuss]

[-- Attachment #1.1: Type: text/plain, Size: 1317 bytes --]

Le lundi 1 février 2021 à 17:40:33 UTC, John MacFarlane a écrit :

>
> We wouldn't embed this directly in pandoc (trying to avoid 
> C dependencies), but it would be easy to create a filter 
> to intercept specially marked code blocks and convert them 
> to pictures. (There are examples of this kind of thing in the 
> pandoc/lua-filters repository.) 
>

John, what is needed to help make a Pikchr filter happen? 

The obvious place at least initially for such code blocks to appear is in 
Markdown. Pikchr is intended (just like PIC was) to be used as a 
plugin/filter in any context, but it's main development environment to date 
has been in the Fossil variant of Markdown, see 
https://www.fossil-scm.org/xfer/md_rules. Pandoc doesn't support Fossil 
Markdown, but  it seems like it would not be hard to do so.

--
Dan Shearer
dan-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/f194310d-8b68-41d5-a13e-28f83fd7b512n%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 1919 bytes --]

Re: Pikchr in Pandoc

['Dan Shearer' via pandoc-discuss]

[-- Attachment #1.1: Type: text/plain, Size: 1960 bytes --]

Le lundi 1 février 2021 à 16:43:36 UTC, ChrisD a écrit :

> I was not aware of Pitchr, so thanks for posting this. I have used dot 
> (graphviz) a lot, but Pitchr looks to fill a different niche. 
>

Yes it does, while also very much being of the do-one-job-well philosophy. 
Not surprising from something Brian Kernighan wrote.

Is Pitchr available as a executable somewhere? All I could find was the C 
> source code file. Thanks, 
>

No, Pikchr is not currently available as an executable. However pretty much 
any C build environment will create an executable as follows.

1. Get the (very small, zero dependency) Pikchr source from one of:
    a) https://pikchr.org/home/download . This is an automatic 
tarball/zip/sqlar from the latest Fossil checkin.
    b) the command "fossil clone https://pikchr.org/"

2. cd pikchr
    make

   this will give you a binary called "pikchr" (probably PIKCHR.EXE for 
Windows, but I have never tried with Windows)

3. You can then try pikchr:

./pikchr --svg-only examples/headings01.pikchr

will produce only the SVG code corresponding to the Pikchr code. 

 ./pikchr examples/headings01.pikchr > /tmp/headings.html

This wraps the SVG in HTML, you can point your web browser at 
/tmp/headings.html

I have an SVG convertor called rsvg-convert from the librsvg2-bin package. 
Using this I can generate PNG:

./pikchr --svg-only examples/headings01.pikchr | rsvg-convert > 
/tmp/headings.png

--
Dan Shearer
dan-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/ab76e66c-7cc6-404b-9d38-4e16351aa424n%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 2958 bytes --]

Re: Pikchr in Pandoc

['Dan Shearer' via pandoc-discuss]

[-- Attachment #1.1: Type: text/plain, Size: 801 bytes --]

Le lundi 1 février 2021 à 17:40:33 UTC, John MacFarlane a écrit :

>
> We wouldn't embed this directly in pandoc (trying to avoid 
> C dependencies), but it would be easy to create a filter 
>

Another relevant document is "How to use Pikchr in Markdown" : 
https://pikchr.org/home/doc/trunk/doc/usepikchr.md

--
Dan Shearer
dan-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/d750d2bc-be80-4341-9b62-ca63424defbdn%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 1349 bytes --]

Re: Pikchr in Pandoc

[John MacFarlane]

"'Dan Shearer' via pandoc-discuss"
<pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> writes:

> Le lundi 1 février 2021 à 17:40:33 UTC, John MacFarlane a écrit :
>
>>
>> We wouldn't embed this directly in pandoc (trying to avoid 
>> C dependencies), but it would be easy to create a filter 
>> to intercept specially marked code blocks and convert them 
>> to pictures. (There are examples of this kind of thing in the 
>> pandoc/lua-filters repository.) 
>>
>
> John, what is needed to help make a Pikchr filter happen? 

You can learn about how to write pandoc filters from the
documentation

https://pandoc.org/filters.html
https://pandoc.org/lua-filters.html

You could, in principle, write the whole filter in C (using
the pikchr liibrary and a JSON-parsing and generating library).
Or you could use any other language.

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/m2czxigyzn.fsf%40MacBook-Pro.hsd1.ca.comcast.net.

Re: Pikchr in Pandoc

['Dan Shearer' via pandoc-discuss]

[-- Attachment #1.1: Type: text/plain, Size: 1133 bytes --]



Le lundi 1 février 2021 à 17:40:33 UTC, John MacFarlane a écrit :

>
> We wouldn't embed this directly in pandoc (trying to avoid 
> C dependencies), but it would be easy to create a filter 
> to intercept specially marked code blocks and convert them 
> to pictures. 
>
 

> Dan Shearer <d...-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org> writes: 
>
> > I have not noticed mention of Pikchr here, and I think it is relevant to 
> > recent discussion of diagrams and also GSoC. 
>

... and that is what someone has just published code to do, see 
https://pikchr.org/home/forumpost/4e032f8b04 . The author is looking for 
feedback.
 
--
Dan Shearer
dan-QNUrB6Xd9YFAfugRpC6u6w@public.gmane.org

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/68fcd43a-b2f8-4869-a212-e79db105113fn%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 1930 bytes --]

Re: Pikchr in Pandoc

['Dan Shearer' via pandoc-discuss]

[-- Attachment #1.1: Type: text/plain, Size: 1268 bytes --]

Le mardi 2 février 2021 à 17:29:16 UTC, John MacFarlane a écrit :

> "'Dan Shearer' via pandoc-discuss" 
> <pandoc-...-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org> writes: 
>
> > Le lundi 1 février 2021 à 17:40:33 UTC, John MacFarlane a écrit : 
> > 
> >> 
> >> We wouldn't embed this directly in pandoc (trying to avoid 
> >> C dependencies), but it would be easy to create a filter 
> >> to intercept specially marked code blocks and convert them 
> >> to pictures. (There are examples of this kind of thing in the 
> >> pandoc/lua-filters repository.) 
> >> 
> > 
> > John, what is needed to help make a Pikchr filter happen? 
>
> https://pandoc.org/lua-filters.html 
>

Here is the filter in Lua: 
https://code.jboy.space/pikchr-filter/file?name=pikchr.lua&ci=tip  .

It assumes the pikchr binary is in the path.

Dan


-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/131b93bd-047c-4020-9ec3-3bb01d26cf83n%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 2205 bytes --]