summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/fixmetodonotes/README
blob: eb56e269dad0bdb11517f8f97ef41ff8822c47a1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
fixmetodonotes
==============

A LaTeX package to highlight and manage FIXME and TODO annotations.


Usage
-----

In the preamble add

    \usepackage{fixmetodonotes}

In the document write notes using

    I believe that in the \FIXME{"next year" or "future"?} the revolution
    will not be televised.

or

    \TODO{add a playful picture}

To show a list of pending notes, together with links to their pages, use

    \listofnotes

The list of notes will be shown like a table of content or a list of figures.


### Creating new kinds of notes

By default, `fixmetodonotes` provides three kinds of notes: `FIXME`, `TODO` and
`CITE`.

It is possible to add declare new kinds of notes using the `\defnote`
command. Notes can be declared as _margin_ or _inline_ notes. It is also
possible to specify new ways to mark the text.

To define a new kind of note called `REMOVE` that displays a margin note
and crosses out the text, use

    \defnote{REMOVE}{margin}{\sout}

Similarly, to define a red highlight marker `STYLE` use

    \defnote{STYLE}{inline}{\NOTES@colorline{red}}


### Automatic "DRAFT" watermark

`fixmetodonotes` will add a "DRAFT" watermark to any page that has at least
one notes.

When all the notes are removed from a page, the watermark will not be produced
at all. This means that it is possible to leave `fixmetodonotes` enabled even
in final versions of the documents.

Use the `nowatermark` option to disable all watermarks.


Installation
------------

The released archives can be installed using the standard LaTeX mechanism.

    latex fixmetodonotes.ins

This will generate a `fixmetodonotes.sty` file that can be moved to a
directory searched by TeX.

You can also install `fixmetodonotes` in your home directory using the
git repository.

    export TEXMFHOME=~/.texmf
    mkdir -p ~/.texmf/tex/latex/
    cd ~/.texmf/tex/latex/
    git clone git://github.com/gioele/fixmetodonotes.git


Contact
-------

The homepage of `fixmetodonotes` is <https://github.com/gioele/fixmetodonotes>.
You can send any issue or comment to <https://github.com/gioele/fixmetodonotes/issues>.


Authors
-------

* Gioele Barabucci <http://svario.it/gioele> (initial author)


License
-------

This is free software released into the public domain (CC0 license).

See the `LICENSE` file or <http://creativecommons.org/publicdomain/zero/1.0/>
for more details.