1
0
Fork 0
mirror of https://github.com/tldr-pages/tldr.git synced 2025-04-22 10:02:10 +02:00
tldr/pages/common/patchwork.md
Daniel Birket 31fa8a04e6
circo, fdp, neato, osage, patchwork, sfdp, twopi: add page (#6284)
* dot: prepare to add all graphviz layout engines

These changes are in preparation for adding commands: `neato`,
`circo`, `twopi`, `pfd`, `spfd`, `osage` and `patchwork`, which use
the same command syntax. This one is to argue over before posting the
other seven that are generated from the same template. Changes:

- use `gv` extension, not `dot`. Author uses `gv`.
- link to command usage guide page
- specify the type of layout in the description (varies)
- use `input` and `image` not `file` or `out_file`
- provide a list of available image formats
- show how to use the engine as a filter
- give the help command

* dot: add link angle-brackets

* Added a static list of layout engines as line 2 of description.

* dot: Accept suggestion to highlight graph type with back-quotes.

* Fix back-quotes around `png`.

* circo, fdp, neato, osage, patchwork, sfdp, twopi : add pages

See #6270, #2580.

This pull-request contains the other seven graphviz layout commands in
addition to `dot`, which is awaiting approval at #6270. These files
are generated from the same template as `dot.md` there. The eight
commands differ in the command name, description line and the content
of the `echo` command in one example. (If any more changes are
required, I will regenerate all the files together.)

* gv layouts: space after flags. -o versus -O. 80 char 2nd line.

* dot: remove back-quotes from stdin, stdout to match tldr usage.

* graphviz layouts : use https not http.

* graphviz layouts : use {{png}} {{svg}} and {{gif}} as requested.
2021-08-02 18:12:07 +01:00

25 lines
854 B
Markdown

# patchwork
> Render an image of a `squareified treemap` network graph from a `graphviz` file.
> Layouts: `dot`, `neato`, `twopi`, `circo`, `fdp`, `sfdp`, `osage` & `patchwork`.
> More information: <https://graphviz.org/doc/info/command.html>.
- Render a `png` image with a filename based on the input filename and output format (uppercase -O):
`patchwork -T {{png}} -O {{path/to/input.gv}}`
- Render a `svg` image with the specified output filename (lowercase -o):
`patchwork -T {{svg}} -o {{path/to/image.svg}} {{path/to/input.gv}}`
- Render the output in `ps`, `pdf`, `svg`, `fig`, `png`, `gif`, `jpg`, `json`, or `dot` format:
`patchwork -T {{format}} -O {{path/to/input.gv}}`
- Render a `gif` image using stdin and stdout:
`echo "{{digraph {this -> that} }}" | patchwork -T {{gif}} > {{path/to/image.gif}}`
- Display help:
`patchwork -?`