summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-02-11 21:16:14 +0000
committerKarl Berry <karl@freefriends.org>2023-02-11 21:16:14 +0000
commit664389d85e86be950cd80065e2af3665a0feadfd (patch)
tree78c812cf43c4ea3e2713af7e6b947e885127ea4f /Master/texmf-dist/doc/generic
parentd6abdd7b762edd06a176a6ca5dfe4bb308a078bc (diff)
circuitikz (11feb23)
git-svn-id: svn://tug.org/texlive/trunk@65785 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic')
-rw-r--r--Master/texmf-dist/doc/generic/circuitikz/CHANGELOG.md13
-rw-r--r--Master/texmf-dist/doc/generic/circuitikz/README.md67
2 files changed, 47 insertions, 33 deletions
diff --git a/Master/texmf-dist/doc/generic/circuitikz/CHANGELOG.md b/Master/texmf-dist/doc/generic/circuitikz/CHANGELOG.md
index 7eb44df6bec..ac9276c8f50 100644
--- a/Master/texmf-dist/doc/generic/circuitikz/CHANGELOG.md
+++ b/Master/texmf-dist/doc/generic/circuitikz/CHANGELOG.md
@@ -1,6 +1,19 @@
<!--- CircuiTikz - Changelog --->
The major changes among the different CircuiTikZ versions are listed here. See <https://github.com/circuitikz/circuitikz/commits> for a full list of changes.
+* Version 1.6.1 (2023-02-11)
+
+ New components: solder jumpers; a couple of small but very useful inversion markers for logical circuits, especially targeted at the mux-demux family; a new inline microphone; a much more versatile hemt; a better legacy `tline`. More tweaks to converters blocks, and a lot of typo/grammar fixes in the manual.
+
+ - Add configurable dashes to the dc symbols in converter blocks (suggested by [user `@dbstf` on GitHub](https://github.com/circuitikz/circuitikz/issues/680))
+ - Add solder jumpers (by Romano)
+ - Add a shape to mark european-style inversion (suggested by [user `yashpalgoyal1304` on GitHub](https://github.com/circuitikz/circuitikz/issues/679)), adjust European-style logic port triangle inversion symbols to match
+ - Add a tail-less mic (suggested by [Dr. Mathhias Jung](https://github.com/circuitikz/circuitikz/issues/689)) and an option to change the thickness of the microphone's bar
+ - Enhance the `hemt` shape with a GaN-hemt as example (suggested by [user `@epsilon-phi` on GitHub](https://github.com/circuitikz/circuitikz/issues/691))
+ - Add anchors and a "bare" option to `tline` (suggested by [Dr. Mathhias Jung](https://github.com/circuitikz/circuitikz/issues/694))
+ - subcircuits are no more experimental
+ - Correction of several typo/grammar errors in the documentation by [quark67](https://github.com/circuitikz/circuitikz/pull/686)
+
* Version 1.6.0 (2022-12-10)
The big change is the refactoring (and enhancement) of the block's code. In addition, double gate MOSes, several fixes all over the map, and quite a lot of anchors were added into the mix.
diff --git a/Master/texmf-dist/doc/generic/circuitikz/README.md b/Master/texmf-dist/doc/generic/circuitikz/README.md
index 82748aa739d..0ddfc1fb822 100644
--- a/Master/texmf-dist/doc/generic/circuitikz/README.md
+++ b/Master/texmf-dist/doc/generic/circuitikz/README.md
@@ -2,17 +2,21 @@
circuitikz
==========
-This package provides a set of macros for naturally typesetting electrical and electronic networks.
+This package provides a set of macros on top of [Ti*k*Z](https://github.com/pgf-tikz/pgf) for naturally typesetting electrical and electronic networks.
It was born mainly for writing Massimo Redaelli's exercise book and exams sheets for the Elettrotecnica courses at Politecnico di Milano, Italy. He wanted a tool that was easy to use, with a lean syntax, native to LaTeX, and supporting directly PDF output format.
-So it was based on the very impressive TikZ package.
+![examle of a complex circuit](./example_ctikz.png)
--------------
## Requirements
-* Tikz/PGF graphics library, version 3
-* xstrings not older than 2009/03/13
+
+`circuitikz` is included with the most common LaTeX systems, so it should work out of the box. Anyway, the main dependency is on Ti*k*Z/PGF, `xstring` and `siunitx` (if used):
+
+* Tikz/PGF graphics library, version 3.1.5b
+* `xstring` newer than 2009/03/13
+* `siunitx`, better if `v2` or newer.
## Installation
The stable version is available on [CTAN](https://ctan.org/pkg/circuitikz?lang=en) and is included within the major latex distributions(Texlive, Miktex). If you want to test the latest version, have a look at http://circuitikz.github.io/circuitikz/. There you can find the latest git-version as a single file, just copy it to your project or to your local tex tree.
@@ -21,17 +25,19 @@ The stable version is available on [CTAN](https://ctan.org/pkg/circuitikz?lang=e
### Stable version
Just place
```latex
- \usepackage[siunitx, RPvoltages]{circuitikz}
+ \usepackage[RPvoltages, siunitx]{circuitikz}% or your preferred options
```
-or other opions; for ConTeXt,
+Be sure to check the options you like — you should at least state one of the "voltage direction" ones, like `RPvoltages` shown above, or the usage of `siunitx` special syntax. Be sure to check the relevant sections in the manual.
+
+For ConTeXt, use
```latex
\usemodule[circuitikz]
```
-in the preamble and compile away, both with PS and PDF target output.
+in the preamble and compile away, both with PS and PDF target output. It is higly recommended to go through the [tutorials in the manual](https://circuitikz.github.io/circuitikz/circuitikzmanualgit.pdf#c) and to learn a bit of Ti*k*Z before for example, go through at least the [basic Ti*k*Z one](https://tikz.dev/tutorial), but there are more suggestions in the documentation.
-### Development version
+### Development or newer version
-If you want to use the git version, go to the [GitHub page for the project](https://circuitikz.github.io/circuitikz/), download the lasted version (or the one you want to use) — it's the links called "download the latest version in a single file". You will have a file called `circuitikzgit.sty` that you should put somewhere in your LaTeX input path; the best place is in the same directory where your main file live. Then, just use it instead of the normal one:
+If you want to use the git version, go to the [GitHub page for the project](https://circuitikz.github.io/circuitikz/), download the last version (or the one you want to use) — it's the links called "download the latest version in a single file". You will have a file called `circuitikzgit.sty` that you should put somewhere in your LaTeX input path; the best place is in the same directory where your main file live. Then, just use it instead of the normal one:
```latex
\usepackage[siunitx, RPvoltages]{circuitikzgit}
@@ -41,50 +47,45 @@ or, for ConTeXt,
\usemodule[circuitikzgit]
```
-### Older versions (v0.9.1 onwards)
+Be aware that options and style files can (and do) change between versions, so you have to check them manually, and that the recommended version is always the one that come with your TeX/LaTeX distribution; use this trick only if you *really* need a newer version!
-If you want to use older versions of `circuitikz` in LaTeX, just append the version number to the package name, as in `circuitikz-$version`:
-```latex
- \usepackage{circuitikz-0.8.3}
-```
-The available versions are specified in the manual.
+### Older version
-In ConTeXt, you can use older version with
-```latex
- \usemodule[circuitikz-0.8.3]
-```
+There is a roll-back mechanism in the package, that let you use older versions if you need them; the details are in the manual, look at the section named *"Incompabilities between versions"* for details.
-Be aware that options can (and do) change between versions, so you have to check them manually.
+You have all the code and the corresponding manual available in the [in the github page](http://circuitikz.github.io/circuitikz/) of the project, since version 0.6 onward.
## More Information and documentation
-More Information can be found in the manual; you can find a compiled version for the "bleeding edge" version
-[in the github page](http://circuitikz.github.io/circuitikz/circuitikzmanualgit.pdf) and for the various releases in the [GitHub releases](https://github.com/circuitikz/circuitikz/releases), where you can find the manual in the assets of each release (since 0.8.3, anyways).
+More Information can be found in the manual; you can find a compiled version for the "bleeding edge" version [in the github page](http://circuitikz.github.io/circuitikz/circuitikzmanualgit.pdf) and for the various releases in the [GitHub releases](https://github.com/circuitikz/circuitikz/releases), where you can find the manual in the assets of each release (since 0.8.3, anyways).
## Contact the authors
For bug reports and enhacement suggestions, the preferred way is to use [the issue page on the project](https://github.com/circuitikz/circuitikz/issues). Please be ready to provide an example code showing the bug, if any.
-Please do not use the issue page for generic help on how to use the package.
-The manual has a (growing) set of examples;
-also the questions tagged `circuitikz` on https://tex.stackexchange.com/ are often answered promptly. You can also find help on [matrix](https://app.element.io/#/room/#pgf-tikz:matrix.org) and on [TopTeX](https://topanswers.xyz/tex).
+Please **do not use the issue page for generic help on how to use the package**. The manual has a (growing) set of examples; also the questions tagged `circuitikz` on https://tex.stackexchange.com/ are often answered promptly. You can also find help on [matrix](https://app.element.io/#/room/#pgf-tikz:matrix.org) and on [TopTeX](https://topanswers.xyz/tex).
+
+Since more or less version 0.9.0 (May 2019) Romano is the main maintainer of the project. You can contact the authors via GitHub (preferred) or via their email addresses:
-* git: https://github.com/circuitikz/circuitikz
+* [GitHub main project page](https://github.com/circuitikz/circuitikz)
* Massimo Redaelli (m.redaelli@gmail.com)
* Stefan Lindner (stefan.lindner@fau.de)
* Stefan Erhardt (stefan.erhardt@fau.de)
* Romano Giannetti (romano.giannetti@gmail.com)
-------------
-Copyright 2018-2022 by Romano Giannetti
-
-Copyright 2015-2022 by Stefan Lindner
-
-Copyright 2013-2022 by Stefan Erhardt
-
-Copyright 2007-2022 by Massimo Redaelli
+### License and copyright
This file may be distributed and/or modified
1. under the LaTeX Project Public License and/or
2. under the GNU Public License.
+Copyright 2018-2023 by Romano Giannetti
+
+Copyright 2015-2023 by Stefan Lindner
+
+Copyright 2013-2023 by Stefan Erhardt
+
+Copyright 2007-2023 by Massimo Redaelli
+
+