summaryrefslogtreecommitdiff
path: root/graphics/circuit_macros/README
diff options
context:
space:
mode:
Diffstat (limited to 'graphics/circuit_macros/README')
-rw-r--r--graphics/circuit_macros/README64
1 files changed, 32 insertions, 32 deletions
diff --git a/graphics/circuit_macros/README b/graphics/circuit_macros/README
index 982ea2a097..1ae81ea52e 100644
--- a/graphics/circuit_macros/README
+++ b/graphics/circuit_macros/README
@@ -1,5 +1,5 @@
-* Circuit_macros Version 9.3, copyright (c) 2020 J. D. Aplevich under *
+* Circuit_macros Version 9.4, copyright (c) 2020 J. D. Aplevich under *
* the LaTeX Project Public Licence in file Licence.txt. The files of *
* this distribution may be redistributed or modified provided that this *
* copyright notice is included and provided that modifications are clearly *
@@ -166,7 +166,7 @@ DPIC:
older versions, see https://repology.org/project/dpic/badges
The best advice is to obtain the newest version.
- The dpic distribution includes a manual dpic-doc.pdf containing a summary
+ The dpic distribution includes dpic-doc.pdf, a manual containing a summary
of the pic language and of features unique to dpic.
EXAMPLES
@@ -182,7 +182,7 @@ EXAMPLES
The examples directory Makefile automates the generation of .ps, .eps,
.png, and .pdf files for individual diagrams. Subdirectories of the
examples directory are for testing metafont, metapost, pgf, psfrag,
- pdf, and xfig examples.
+ and xfig examples.
INTEGRATION WITH OTHER TOOLS:
Installation and usage of the macros have evolved smewhat since the
@@ -191,7 +191,7 @@ INTEGRATION WITH OTHER TOOLS:
I simply added commands to the appropriate Makefiles. However, others
have developed tools that simplify workflow for their circumstances.
The following are representative but keep in mind that systems and
- installations evolve ovr time:
+ installations evolve over time:
A Python-based GUI called PyCirkuit is
at https://pypi.org/project/pycirkuit/ and
@@ -216,15 +216,18 @@ INTEGRATION WITH OTHER TOOLS:
A KDE interface created by Matteo Agostinelli can be found
at http://wwwu.uni-klu.ac.at/magostin/cirkuit.html. A git
- repository of a newer version of cirkuit by Andrew G. for Linux
- is at https://github.com/ag-ckt/cirkuit/tree/V0.5.0. There is
- uncertainty about installation possibilities because of changes in
- library dependencies.
+ repository of a newer version by Andrew G. for Linux is at
+ https://github.com/ag-ckt/cirkuit/tree/V0.5.0. There is uncertainty
+ about installation possibilities because of evolving library dependencies.
A wiki offering examples and tips is at
http://swwiki.e-dschungel.de/circuit_macros
It is in German but Google translate works well on the page.
+ Another recent introduction is at
+ https://www.root.cz/clanky/publikovanie-elektrickych-schem-a-diagramov-pomocou-circuit-macros/
+ It is in Czech but, again, Google translate works well.
+
LaTeX automation tools are discussed at, for example,
http://tex.stackexchange.com/questions/64/tools-for-automating-document-compilation
@@ -240,10 +243,12 @@ VARIATIONS
needs and taste. They continue to evolve in my own library as I use
them and as others send comments. No such collection can hope to
include all possible circuit-related symbols, so you will probably
- find yourself writing your own macros or adapting some of these. Be
- careful to rename modified macros to avoid confusion. The learning
- curve compares well to other packages, but there is no trivially easy
- way to produce high-quality graphics.
+ find yourself writing your own macros or adapting some of these.
+ Be careful to rename modified macros to avoid confusion. The learning
+ curve compares well to other packages, but there is no trivially
+ easy way to produce high-quality graphics. (If a picture is worth
+ a thousand words, ask yourself how long it would take to write and
+ revise a thousand words.)
See eschpic on Github for IEC-style electrical drawings.
@@ -282,28 +287,23 @@ Postscript, CorelDraw, Adobe Illustrator:
SVG output, Inkscape:
Dpic -v produces svg output. If the result is to be directly
- inserted into html, then as for Postscript output, the diagram source
- file has to be adapted to remove any LaTeX formatting. The configuration
- file svg.m4 contains macros that can assist.
-
- If SVG is the ultimate goal, then it may be advisable to use the tool
- dvisvgm to convert dvi to svg. An alternative on some systems is to
- produce pdf and then use pdf2svg, since the font selection and formatting
- problems associated with direct production of svg are eliminated.
+ inserted into html, then as for Postscript output, the diagram
+ source file has to be adapted to remove any LaTeX formatting. The
+ configuration file svg.m4 contains macros that can assist. To avoid
+ this problem at the expense of an extra postprocessing step,
+ sophisticated text formatting and font selection can be retained
+ by first producing pdf output and then converting to SVG using,
+ say, pdf2svg (https://github.com/dawbarton/pdf2svg) or dvisvgm
+ (https://www.ctan.org/pkg/dvisvgm).
SVG is the native file format for the Inkscape graphics editor.
- Therefore, elements defined by these macros can be output by dpic -v
- in svg format for later manipulation by Inkscape. A basic palette
- of circuit elements for importing into Inkscape is found in
- examples/svg/paletteSVG.m4. In the svg subdirectory, type
- "make paletteSVG.svg", read the resulting file into Inkscape, and then
- ungroup the elements as desired. You would probably wish to add to or
- customize these elements for extensive use.
-
- Recent Inkscape versions can export graphics to eps or pdf format
- and text to tex format, so that labels can be formatted by LaTeX and
- overlaid on the graphics file. This process allows the use of Inkscape
- to place and embellish circuit elements.
+ Therefore, elements defined by these macros can be output by dpic
+ -v in svg format for later manipulation by Inkscape. A very basic
+ palette of circuit elements for importing into Inkscape is found
+ in examples/svg/paletteSVG.m4. In the svg subdirectory, type "make
+ paletteSVG.svg", read the resulting file into Inkscape, and then ungroup
+ the elements as desired. You would probably wish to add to or customize
+ these elements for extensive use.
Metafont:
The file examples/mf/cct.mf is a Metafont source for a few variants of