Skip to content

Commit

Permalink
minor clarifications to setup (#98)
Browse files Browse the repository at this point in the history
Co-authored-by: Bradley Miller <bmiller@Njord.local>
  • Loading branch information
bnmnetp and Bradley Miller committed Mar 13, 2020
1 parent e532a5e commit dfd2fc2
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 5 deletions.
7 changes: 5 additions & 2 deletions Makefile.paths.original
Expand Up @@ -31,6 +31,9 @@

# Provide full paths for three variables,
# each without a trailing slash
# Note: In order to build the html version you should use the
# absolute path (/users/oscar/Github/mathbook) and not the relative
# path ../mathbook

# PreTeXt distribution root
# Example: PTX = ../mathbook (or PTX = /users/oscar/GitHub/mathbook)
Expand All @@ -41,7 +44,7 @@ PTX =
DMOI =

# Products are built in subdirectories
# of a "scratch" directory
# of a "scratch" directory
# or use SCRATCH = $(DMOI) to build inside main repository.
SCRATCH = $(DMOI)

Expand All @@ -54,7 +57,7 @@ SCRATCH = $(DMOI)
ENGINE = pdflatex

# PDF viewer (eg "open -a preview" on Mac)
PDFVIEWER =
PDFVIEWER =

# HTML viewer (eg "open -a firefox", "open -a safari", on Mac)
HTMLVIEWER = chrome
6 changes: 3 additions & 3 deletions README.md
Expand Up @@ -12,7 +12,7 @@ This text is written in [PreTeXt](http://mathbook.pugetsound.edu) (previously ca

### Preliminaries

To compile from source, you will need a copy of the mathbook xsl stylesheets, as well as xsltproc, python, and make installed (should be easy on linux or MacOS, but also possible on Windows---see some [windows installation notes](http://mathbook.pugetsound.edu/doc/author-guide/html/windows-install-notes.html)).
To compile from source, you will need a copy of the mathbook xsl stylesheets, as well as xsltproc, python, LaTeX, and pdf2svg and make installed (should be easy on linux or MacOS, but also possible on Windows---see some [windows installation notes](http://mathbook.pugetsound.edu/doc/author-guide/html/windows-install-notes.html)).

Earlier editions, that did not include WeBWorK problems were easy enough to compile using commands like `xsltproc --xinclude ../xsl/custom-latex.xsl ../ptx/dmoi.ptx`. Now though, there are enough intermediate steps that I've written a make file that keeps everything together. As long as you have all the tools installed, this should make things easy.

Expand Down Expand Up @@ -50,12 +50,12 @@ And then create the html:

`make html`

If you look in the makefile, you will see some shortcuts that combine some of these.
If you look in the makefile, you will see some shortcuts that combine some of these.


## Contributing

Any and all suggestions to improve the text are welcome. Thanks to those who have already pointed out typos/issues they have found. If you would like to make a more substantial contribution, please contact me so we can discuss how best to proceed.
Any and all suggestions to improve the text are welcome. Thanks to those who have already pointed out typos/issues they have found. If you would like to make a more substantial contribution, please contact me so we can discuss how best to proceed.

## Previous editions

Expand Down

0 comments on commit dfd2fc2

Please sign in to comment.