summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/plain/plipsum/README
blob: dd5def6ff6f0dd24cf09a4f22f8e15c4f5f3d80c (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
P-LIPSUM
========

'Lorem ipsum' paragraphs generator for the purposes
of the plain TeX developers.

Author: Sergio Spina <sergio.am.spina@gmail.com>

Version: 4.2 of 2013.05.06


Contents of the package
-----------------------

-   `plipsum.nw`: the source file
-   `plipsum.tex`: the format
-   `pliptest.tex`: an example file
-   `plipsum-doc.pdf`: the documentation
-   `compile.sh`: the installation program
-   `stripc`: a python filter
-   `README.md`: this file


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

-   Run `plipsum.nw` through noweb. You van find it on the Norman Ramsey
    web page (<http://www.cs.tufts.edu/~nr/noweb/>) or on CTAN
    (<http://www.ctan.org/tex-archive/web/noweb>).
  
    A suitable command can be:

        $ notangle -Rplipsum.tex plipsum.nw | ./stripc > plipsum.tex

    `stripc` is a python filter that strips away comments and blank spaces
    from the final file.

-   Move the resulting `.tex` file to a place where TeX finds it.	
    On a TDS compliant system this should be (substitute `$TEXMF` 
    with your local or home texmf directory):

        $TEXMF/tex/plain/plipsum/

-   If you like to, move the source file (`.nw`) in a
    source directory of your system.

-   Update your filename database. How to achieve this depends 
    on your system. For TeXlive one of these commands should work:

        $ texhash ~/texmf
        $ sudo mktexlsr ~/texmf
  
    More info on this is available with:
  
        $ texhash --help
        $ sudo mktexlsr --help
  
-   If you are using a non TDS compliant system you are on your own; take a
    look in the documentation how to install new packages.

-   If you are using windows (TM) you are on your own even more.


License
-------
This material is subject to the LaTeX Project Public License. See
 
        http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html 

for the details of that license. 


Enjoy plipsum. Happy TeXing.


= END =