glia graph

¶Useful for representing...
:
    * site indexes
    * processes ("flows")
    * argument mapping, see ^XXX🔗polemics
    * nature-system diagrams
    * psycho-social networks & dynamics
    * protocols & game descriptions
    * people-tag networks
    * ### WE NEED POST-PROSAIC ("umetniško pero"), TACTICAL EXPRESSION MECHANISMS
    * essays, posts, etc are not necessary consequential (contingent outcomes)
    * website intertwingularity analysis
        * show which parts of website have "passages" to other parts"
        * can expose weird/private links (especially if scraped dump)
    * other 🔗representation-systems
    * social media relation graphs (with plugins)
    * graphs of relations by word2vec, TF-IDF, making wordclouds (with plugins)
    * [...]

¶Demos / examples
:
    * ^TOTALISM-OLD🔗dev-graph-test-dev (testing features) !
    * 🔗graph-index totalism.org sitemap
    * 🔗graph-postapple
    * 🔗farming
    * 🔗why-how-what
    * 🔗graph-beer
    * 🔗trails
    * 🔗tfc17
    * [...]
    * ### [!!]

Deprecated / needs update:
    * ^TOTALISM-OLD🔗graph-neu
    * ^TOTALISM-OLD🔗dev-graph-test3:
        shows need for render control (for circular!)
    * [...]
[!!*] merge with above 

¶* describing graphs

    * A,B,C,D,E :
        all undirected and interconnected

    * A>B>C>D>E or A<B<C<D<E :
        directed graph

    * A<>B :
        co-position (bothways arrowheads)

    * X:A,B,C,D,E (or X,:...):
        all connected only to first one ("subset of X")

    * X>:A,B,C,D,E (or X<:... or X<>:...) :
        same as above, but directed!

    * X >[Y] Z :
        labeled connection

¶* referencing nodes

    * ~~X:
        approximate matching using substring matching or levenshtein distance as fallback

    * ^ :
        reference to FIRST item in previous line

    * $ :
        reference to LAST item in previous line

¶* node styles

    * !X (or !: ...):
        "strong" X (expose)

    * ~X (or ~: ...):
        "emphasis" X

    * _X (or _: ...):
        "underline" X

    * %X (or %: ...):
        "strikeout" X

¶* crawling collections

    (for 🔗E2H pods)
    (plugins available for other collections, like MediaWiki, etc)

    * @@<depth>pad (or @@<depth>: ...):
        include the links from pad(s) as nodes!
        basically a crawler!
        <depth> is optional (default is 1)

    * @@@pad
        similar to @@, but depth is controlled by the CRAWLDEPTH directive (default is 3)

¶* special directives

    * "#!ENGINE=X":
        use another graphviz layout engine
        see → https://www.graphviz.org/doc/info/lang.html
        default:
            * "dot"
        others looking useful:
            * "circo": renders in circular way!
            ###[!] document
            * "fdp"
            * "neato"
            * "twopi"
            * "sfdp"
        others needing work [!]
            (need tweaking of graphviz settings!)
            * "patchwork"

    * "#!LON":
        link on nodes

    * "#!COLOR=X":
        * "random": node color is randomly generated, edge colours follow nodes (default)
        * "props": color is determined by node properties
        * "B&W": black and white
        * "<mode>+-": adding +- to color mode makes edge label [+] a green connection, [-] a red connection, and black otherwise
        degree, degreeIn, .. [!]

    * "#!TOOLTIP=false":
        no tooltip on nodes
    
    * #!SHAPE=X:
        http://www.graphviz.org/doc/info/shapes.html
        rect, oval, box3d, star, [...]

    * "#!OVERLAP=X":
        * "scale": scales graph until there are no overlaps (default)
        * "prism": ???
        * "orthoxy": ???
        * see: http://www.graphviz.org/doc/info/attrs.html#d:overlap

    * "#!EDGESTYLE<|.directed|.undirected|.bidirected>=Y" :
        first:
            * "": all edges
            * ".directed": directed edges
            * ".undirected": undirected edges
            * ### : both sided?
        * second, also see graphviz documentation:
            * invis (invisible)
            * solid (default)
            * dashed
            * dotted
            * bold <--- #TODO: I see no change - maybe if penwidth would be unset?
        ----------------------
        examples:
            #!EDGESTYLE=dashed
            #!EDGESTYLE.undirected=dashed
            #!EDGESTYLE.directed=invis

¶* requests settings

Request defaults:
    * input:
        E2H pad (sourceMethod=http/totalism, sourceFormat=text/graph/t-graph)
    * output:
        SVG (sinkFormat=graph/svg)
    * engine/renderer:
        "dot" (graphviz.ENGINE=dot)

¶* (tips & tricks)

    * entities are trimmed
    * lines are split at ~32 characters + current word
    * "hanging node" with no connections is displayed

    * pass different, but same-looking (same label) entity:
        use single uppercase letter after tag
        like "some label #A"

    * [...]