Rewrote README.md to reflect recent changes

fixes #8
This commit is contained in:
gabe 2022-01-16 11:23:44 -06:00
parent 29c7ad1ced
commit 79efc5eb7c

View file

@ -7,21 +7,22 @@ ASCIIsite is a simple, bare bones static site generator. You give it a directory
## Usage
ASCIISite takes 2 (so far) optional arguments followed by the single mandatory argument telling it what directory to convert.
ASCIISite several optional arguments followed by a single mandatory argument telling it what directory to convert.
the -o or --output option simply tells ASCIISite what to name the output file.
the -z or --compress flag tells ASCIISite to put the final product in a compressed tar.gz file as its output.
This is especially useful if you are running ASCIISite on your personal computer, and will be uploading the tar.gz file to your server.
the --exclude flag allows you to specify a list of glob patterns. Any file matching these glob patterns will not be copied to the output.
The --sylesheet options allows you to set a custom stylesheet to use instead of the default ASCIIDoctor stylesheet.
The --exclude flag allows you to specify a list of glob patterns. Any file matching these glob patterns will not be copied to the output.
The --exclude-file flag allows you to specify a file containing one glob to exclude per line. Other than inputting from a file, works exactly the same as --exclude. Note that it cannot parse the full spec of .gitignore files, only traditional globs.
Exclusions are helpful for any files that are needed for the compilation of the asciidoc files, but do not need to be in the final site.
The main use case I am aware of is files that are put into an asciidoc document via an include statement.
As for how to format the input directory, thats up to you. The directory structure of the input will be mirrored in the structure of the output website.
The only real rule you need to follow is that all your links to other pages in the input directory should be relative, so they dont get broken when you move the output directory around.
@ -31,7 +32,6 @@ Say you have a nice asciidoctor directory like this:
```
test
├── dir
│   ├── collatz.py
│   └── subdir
│   └── linked.adoc
├── images
@ -45,20 +45,21 @@ Where some pages link to others, some pages include others, and some pages have
You can run
```
ASCIISite.py -o result test
ASCIISite.py -o output test
```
to get a file tree like:
```
result
output
├── css
│   └── asciidoctor.css
├── dir
│   ├── collatz.py
│   └── subdir
│   └── linked.html
├── images
│   └── test_pattern.svg
├── include
│   └── include.txt
├── images
│   └── test_pattern.svg
└── landing_page.html
```
@ -70,9 +71,10 @@ ASCIIsite.py --exclude 'include*' -o output test
will get you an output like:
```
result
output
├── css
│   └── asciidoctor.css
├── dir
│   ├── collatz.py
│   └── subdir
│   └── linked.html
├── images
@ -80,9 +82,30 @@ result
└── landing_page.html
```
Alternatively, you can run
and, to use your custom stylesheet named `+myTheme.css+`, you can use:
```
ASCIISite.py -z -o result test
ASCIIsite.py --stylesheet myTheme.css -o output test
```
to get a .tar.gz file containing the result directory.
```
output
├── css
│   └── myTheme.css
├── dir
│   └── subdir
│   └── linked.html
├── include
│   └── include.txt
├── images
│   └── test_pattern.svg
└── landing_page.html
```
Alternatively, you can run
```
ASCIISite.py -z -o output test
```
to get a .tar.gz file containing the output directory.