added md2pic cli tools

Author: gebv

Makefile

@@ -12,3 +12,6 @@ heroku-build-and-deploy:
 	heroku container:release web
 heroku-stats:
 	heroku ps -a pikchr-render-server
+
+md2pi:
+	go run ./cmd/md2pikchrs/main.go -in ./_tmp/*.md -out ./_out

README.md

@@ -20,6 +20,8 @@ You can use a shared server for rendering (set by default in settings in the vsc
 
 If you have questions, comments, or suggestions, please visit the [GitHub Discussion board](https://github.com/gebv/pikchr/discussions).
 
+**CLI tools for render SVG from your md file with code blocks with source code of diagram**. [Follow link](./cmd/md2pikchrs/README.md) for details
+
 
 # What is pikchr?
 

_out/fil1.svg

@@ -0,0 +1,31 @@
+```pikchr fil1.svg
+arrow right 200% "Markdown" "Source"
+box rad 10px "Markdown" "Formatter" "(markdown.c)" fit
+arrow right 200% "HTML+SVG" "Output"
+arrow <-> down from last box.s
+box same "Pikchr" "Formatter" "(pikchr.c)" fit
+```
+
+```pikchr foo bar
+arrow right 200% "Markdown" "Source"
+box rad 10px "Markdown" "Formatter" "(markdown.c)" fit
+arrow right 200% "HTML+SVG" "Output"
+arrow <-> down from last box.s
+box same "Pikchr" "Formatter" "(pikchr.c)" fit
+```
+
+```pikchr foo bar.svg
+arrow right 200% "Markdown" "Source"
+box rad 10px "Markdown" "Formatter" "(markdown.c)" fit
+arrow right 200% "HTML+SVG" "Output"
+arrow <-> down from last box.s
+box same "Pikchr" "Formatter" "(pikchr.c)" fit
+```
+
+```pikchr foo_bar.svg
+arrow right 200% "Markdown" "Source"
+box rad 10px "Markdown" "Formatter" "(markdown.c)" fit
+arrow right 200% "HTML+SVG" "Output"
+arrow <-> down from last box.s
+box same "Pikchr" "Formatter" "(pikchr.c)" fit
+```

_out/foo_bar.svg

@@ -0,0 +1,92 @@
+# MD to pic
+
+cli tools to integrate into your development process.
+
+How it works? `md2pikchrs` parse your markdown files and generated SVG files for each found code block with magic text. What is `magic text`? Follows example below
+
+It is your markdown file
+
+<pre class="language-text">
+ # Some header
+
+ some text
+
+ more text...
+
+ ```json
+ {"foo":"bar"}
+ ```
+
+ ```bash
+ echo "some scripts"
+ ```
+
+ end more more code blocks
+
+ but if the block language matters __pikchr__ and after it there will be more text
+
+ ```pikchr some text
+ arrow right 200% "Markdown" "Source"
+ box rad 10px "Markdown" "Formatter" "(markdown.c)" fit
+ arrow right 200% "HTML+SVG" "Output"
+ arrow <- down from last box.s
+ box same "Pikchr" "Formatter" "(pikchr.c)" fit
+ ```
+
+ will be generated file `some_text.svg` with SVG diagram
+</pre>
+
+# How to use
+
+NOTE: in the code block, the first line with the language name is called `string info`. First word it is language name.
+
+- create code block with language `pikchr`
+- after the language name, everything that will be specified will be the name of the generated file (before line break).
+
+Nothing will be generated - not specified file name
+<pre>
+```pikchr
+</pre>
+
+Nothing will be generated - must be `pikchr` language name
+<pre>
+```json
+</pre>
+
+Will be generated svg file with name `foo_bar.svg`
+<pre>
+```pikchr foo bar
+</pre>
+
+... and the some name `foo_bar.svg`
+<pre>
+```pikchr foo_bar.svg
+</pre>
+
+... and the same name `foo_bar.svg`
+<pre>
+```pikchr foo bar.svg
+</pre>
+
+
+```bash
+md2pikchrs
+    --out=./out/dir/with/gens/svg/fiels
+    --in=./*.md
+```
+
+NOTE: Files with the same name are overwritten
+
+
+
+
+
+
+
+
+
+
+
+
+
+

_tmp/demo.md

@@ -0,0 +1,73 @@
+package main
+
+import (
+	"flag"
+	"io/ioutil"
+	"log"
+	"os"
+	"path/filepath"
+	"strings"
+
+	"github.com/gebv/pikchr"
+	"github.com/gebv/pikchr/markdown"
+)
+
+var fOutDir = flag.String("out", "./out", "Sets dir for exported diagram files.")
+var fInFile = flag.String("in", "./*.md", "Input markdown file.")
+
+func main() {
+	flag.Parse()
+	validFlags()
+	filepath.Walk(*fInFile, func(path string, info os.FileInfo, err error) error {
+		if info.IsDir() {
+			log.Println("Skipped dir:", path)
+			return nil
+		}
+		fileDat, err := ioutil.ReadFile(path)
+		if err != nil {
+			log.Println("Failed open and read file:", path, err)
+			return nil
+		}
+		md, err := markdown.Parse(string(fileDat))
+		if err != nil {
+			log.Println("Failed parse md file:", path, err)
+			return nil
+		}
+		interestedBlocks := []markdown.MarkdownCodeBlock{}
+		log.Println(path, "total", len(md.CodeBlocks()), "code blocks")
+		for _, block := range md.CodeBlocks() {
+			if block.Language() == "pikchr" && block.StringInfoAfterLanguageName() != "" {
+				interestedBlocks = append(interestedBlocks, block)
+			}
+		}
+		log.Println(path, len(interestedBlocks), "interesting code blocks")
+		for _, block := range interestedBlocks {
+			fileName := strings.ReplaceAll(strings.TrimSpace(strings.ToLower(block.StringInfoAfterLanguageName())), " ", "_")
+			log.Println(path, "\t", fileName, "rendering...")
+			renderRes, ok := pikchr.Render(block.Content().Raw())
+			if !ok {
+				log.Println(path, "\t", fileName, "failed render:", renderRes.Data)
+				continue
+			}
+			if !strings.HasSuffix(fileName, ".svg") {
+				fileName += ".svg"
+			}
+			if err := ioutil.WriteFile(filepath.Join(*fOutDir, fileName), []byte(renderRes.Data), 0644); err != nil {
+				log.Println(path, "\t", fileName, "failed write the generated file:", err)
+			}
+			log.Println(path, "\t", fileName, "- OK")
+		}
+		return nil
+	})
+}
+
+func validFlags() {
+	if fOutDir == nil || *fOutDir == "" {
+		log.Println("Please sets the out dir.")
+		os.Exit(1)
+	}
+	if fInFile == nil || *fInFile == "" {
+		log.Println("Please sets in file\\files.")
+		os.Exit(1)
+	}
+}

_tmp/some.file

@@ -28,6 +28,10 @@ type MarkdownCodeBlock struct {
 	content *syntax.CodeBlock
 }
 
+func (b MarkdownCodeBlock) SyntaxBlock() *syntax.CodeBlock {
+	return b.content
+}
+
 func (b MarkdownCodeBlock) Language() string {
 	// NOTE: shuld be one
 	stringInfo := b.StringInfo().Content()[0]