From 873ebff0d1032c6f18c9a09a0c8e0df25a057ca6 Mon Sep 17 00:00:00 2001 From: north Date: Mon, 2 Jul 2007 20:35:53 +0000 Subject: [PATCH] make linkable question tags in FAQ --- doc/FAQ.html | 168 +++++++++++++++++++++++++-------------------------- 1 file changed, 84 insertions(+), 84 deletions(-) diff --git a/doc/FAQ.html b/doc/FAQ.html index 88f9328eb..4595ed92b 100644 --- a/doc/FAQ.html +++ b/doc/FAQ.html @@ -20,9 +20,9 @@ for a partial list of compatible tools and packages.

General

- -Q. Where can I see a list of all the attributes that control dot or neato? - + +Q1. Where can I see a list of all the attributes that control dot or neato? +

See @@ -33,9 +33,9 @@ command-line usage and output formats.

- -Q. Where can I discuss Graphviz? - + +Q2. Where can I discuss Graphviz? +

We run a mailing list.

@@ -83,9 +83,9 @@ text form, fill in the fields, and email it to gviz-bugs@research.att.com.

- -Q. I'm trying to make a layout larger. How? - + +Q3. I'm trying to make a layout larger. How? +

There are various ways to increase the size of a layout. In doing this, one has to decide if the sizes of the nodes and text should be @@ -139,9 +139,9 @@ manually adding a command such as 2 2 scale where the Postscript environment is set up. Make sure to adjust the BoundingBox too if your tools look at this header.

- -Q. How can I join or merge certain edge routes in dot? - + +Q4. How can I join or merge certain edge routes in dot? +

You can try running dot -Gconcentrate=true or you can introduce your own virtual nodes drawn as tiny circles where @@ -195,9 +195,9 @@ Set the label at the end of the graph (before the closing brace), after all its contents have been defined. (We admit it seems desirable to define some special syntax for non-inherited attribute settings.)

- -Q. How can I draw multiple parallel edges in neato? - + +Q5. How can I draw multiple parallel edges in neato? +

This is possible when the splines attribute is false, which is the default. When splines=true, we have no good answer but @@ -262,17 +262,17 @@ A similar check is done for logical tails. In these cases, the edge is drawn between the real nodes as usual.

- -Q. Clusters are hard to see. - + +Q6. Clusters are hard to see. +

Set bgcolor=grey (or some other color) in the cluster.

- -Q. How can I symmetrize (balance) tree layouts? - + +Q7. How can I symmetrize (balance) tree layouts? +

When a tree node has an even number of children, it isn't necessarily centered above the two middle ones. If you know the order of the children, @@ -298,9 +298,9 @@ layouts other than trees, too).

Output features

- -Q. How can I get high quality (antialiased) output? - + +Q8. How can I get high quality (antialiased) output? +

The easiest thing may be to make the layout in Postscript (option -Tps), then run through Ghostview with @@ -328,18 +328,18 @@ built from source, and binary RPMs for Fedora Core 5 (test 2) are available. Then you need to install the optional graphviz-cairo plugin. (n.b. we tried cairo-1.0.2-1.fc4.remi for FC4 - it has errors.)

- -Q. I can only get 11x17 output. - + +Q9. I can only get 11x17 output. +

It's not us! It's probably your printer setup. If you don't believe this, run dot -Tps and look at the BoundingBox header. The coords are in 1/72ths of an inch.

- -Q. How do I create special symbols and accents in labels? - + +Q10. How do I create special symbols and accents in labels? +

The following solution only works with the raster drivers that load Truetype or Type1 @@ -459,9 +459,9 @@ the effect you want. The intention is to support arbitrary font changes within running text in the not-too-distant future.

- -Q. In plain format, splines do not touch the nodes (arrowheads are missing). - + +Q12. In plain format, splines do not touch the nodes (arrowheads are missing). +

Edges are specified as the main spline and, if necessary, arrowheads which actually abut the node. If the arrowheads are not given, drawing @@ -475,9 +475,9 @@ A workaround is to set Since the edges have no arrowheads, the spline specification will go all the way to both nodes.

- -Q. Record nodes are drawn differently in dot and neato when rankdir=LR. - + +Q13. Record nodes are drawn differently in dot and neato when rankdir=LR. +

It's true. dot -Grankdir=LR rotates record nodes so that their top level fields are still listed across levels. rankdir=LR has no effect in neato. @@ -489,9 +489,9 @@ record labels in { } to rotate/unrotate the record contents. See also, How To Avoid Foolish Consistency by Scott Berkun (Microsoft Corp.)

- -Q. How can I print a big graph on multiple pages? - + +Q14. How can I print a big graph on multiple pages? +

The page attribute, if set, tells Graphviz to print the graph as an array of pages of the given size. Thus, the graph @@ -523,9 +523,9 @@ eventually remove the JPEG driver, but North is reluctant to change anything that people might already rely on.

- -Q. How can I get custom shapes or images in my graph? - + +Q16. How can I get custom shapes or images in my graph? +

Please see the @@ -544,9 +544,9 @@ Check that the NUMLOCK key is off. It's a known bug.

- -Q. Why does dotty report a syntax error on a legal dot file? - + +Q18. Why does dotty report a syntax error on a legal dot file? +

Typically this error is reported as: 

@@ -648,22 +648,22 @@ use dotty to render it.  How?
 

 Just run dotty on it. Dotty will use the given pos attributes.
 

-
-Q. Same as above, but I have only node coords, not edges.
-
+
+Q25. Same as above, but I have only node coords, not edges.
+
 

 neato -n is some help, but neato doesn't handle
 spline-based parallel edges. 
 

-
-Q. How can I make client-side image maps?
-
+
+Q26. How can I make client-side image maps?
+
 

 Use the -Tcmap command line option (only version 1.8.9 and beyond!)
 

-
-Q. Why aren't my server-side maps being recognized? I've checked the HTML!
-
+
+Q27. Why aren't my server-side maps being recognized? I've checked the HTML!
+
 

 Make sure that your server has map files enabled. For example, if running
 apache, check that httpd.conf has a line like the following:
@@ -690,9 +690,9 @@ Someone has also suggested using the
 
 Perl module for Graphviz.
 

-
-Q. How can I get 3D output?
-
+
+Q29. How can I get 3D output?
+
 

 The Graphviz authors have qualms about the gratuitous use of 3D.
 

@@ -710,15 +710,15 @@ This would need some (minor) driver work and a good 7-dimensional viewer. Well,
 dim=3 ought to be possible.
 
 
Problems

-
-Q. How can I avoid node overlaps in neato?
-
+
+Q30. How can I avoid node overlaps in neato?
+
 

 Use the graph attribute overlap.
 

-
-Q. How can I avoid node-edge overlaps in neato?
-
+
+Q31. How can I avoid node-edge overlaps in neato?
+
 

 Use the overlap attribute to leave room among the nodes, then
 use -Gsplines=true.
@@ -734,9 +734,9 @@ The actual value may require some tinkering.
 slows down neato, so should be used sparingly and only
 with modest-sized graphs.
 

-
-Q. Neato runs forever on a certain example.
-
+
+Q32. Neato runs forever on a certain example.
+
 

 First, how big is your graph? Neato is a quadratic algorithm, roughly
 equivalent to statistical multidimensional scaling. If you
@@ -772,18 +772,18 @@ Note that, if you have a large graph, the generation of edges as splines
 is a cubic algorithm, so you would do well to avoid using splines=true.
 (This commment applies to circo, fdp and twopi as well.)
 

-
-Q. Edge label placement in neato is bad.
-
+
+Q33. Edge label placement in neato is bad.
+
 

 Difficult problem.  We're working on it.
 If anyone has some general
 label placement code (e.g. a simulated annealer based on the Marks et al.
 technique in Graphics Gems IV), please get in touch.
 

-
-Q. Dot runs forever on a certain example.
-
+
+Q34. Dot runs forever on a certain example.
+
 

 Try dot -v to observe its progress.
 

@@ -858,9 +858,9 @@ In particular, note that there are no guarantees that neato will produce
 a planar layout of a planar graph, or expose all or most of a graph's
 symmetries.
 

-
-Q. Webdot doesn't work.
-
+
+Q36. Webdot doesn't work.
+
 

 We assume you're using Apache and have TCL installed.
 If you don't, it's probably better to just use the
@@ -926,9 +926,9 @@ of a graph as a cgi-bin argument, so it wouldn't need
 permission to fetch a graph remotely.
 This is left as an exercise for the Open Source Community.
 

-
-Q. I have "Font not found" errors, or text labels missing in webdot.
-
+
+Q37. I have "Font not found" errors, or text labels missing in webdot.
+
 

 Firstly, recent versions of graphviz will use fontconfig if it is available
 on your platform.  With fontconfig, this error should not occur, so you
@@ -953,9 +953,9 @@ the webdot script, or recompile Graphviz with the correct DEFAULT_FONTPATH
 (or set fontpath="/your/font/directory" in every graph you lay out,
 but that's pretty clumsy.)
 

-
-Q. My browser doesn't recognize SVG.
-
+
+Q38. My browser doesn't recognize SVG.
+
 

 The correct MIME type for svg images is: image/svg+xml   (note "+" not "-").
 

@@ -994,9 +994,9 @@ No, this is a false positive reported by various security software.
 See http://www.pcreview.co.uk/forums/thread-1689630.php or
 http://spywareblog.com/index.php/2004/11/24/is_libexpat_dll_spyware.
 

-
-Q. What is the coordinate transformation between the graph bb and a .png image?
-
+
+Q40. What is the coordinate transformation between the graph bb and a .png image?
+
 
    
 
  1. 
 The bb is expanded by 4 graph-units in all directions (pad) to allow for finite line widths.
-- 
2.40.0