From the oso2pdf README:

This computer program attempts to convert book chapters downloaded from Oxford Scholarship Online to PDF. The PDFs are better than those the OSO website can generate: the pages of the PDF correspond to the pages of the original book, and the typography is nicer. The hard work is done by Pandoc and LaTeX.

This document is a brief guide to installing and using oso2pdf on Apple Macintosh computers.

How to install

  1. Download and install MacTeX (direct download link).
  2. Download and install Pandoc (direct download link).
  3. Download a compressed archive containing the oso2pdf executables. In what follows I assume that you downloaded this file to your “Downloads” directory in your home folder.
  4. Use Spotlight to open Terminal.app.
  5. Into the terminal, type each of the following commands.
    • Hit enter to commit each command.
    • In the below, each line is a distinct command to be entered in sequence.
    • You can copy and paste!
mkdir $HOME/bin
cd $HOME/Downloads
tar xfz oso2pdf-0.1.0-x86_64-osx.tar.gz
cd $HOME/bin
mv $HOME/Downloads/oso2pdf-0.1.0-x86_64-osx/* .
cd $HOME

(You may now delete anything left in your Downloads folder.)

How to convert a book chapter

  1. In your web browser, open the book chapter in Oxford Scholarship Online, and use File–>Save Page As to save it to your hard drive.

    • I assume for this example that you have saved the file as “My Chapter.html” in your Downloads folder.
  2. Use Spotlight to open Terminal.app.

  3. Into the terminal, type each of the following commands.
    • Hit enter to commit each command.
    • In the below, each line is a distinct command to be entered in sequence.
export PATH=$HOME/bin:$PATH
cd $HOME/Downloads
oso2pdf --font="Times New Roman" "My Chapter.html"

This should leave you with two new PDFs, “My Chapter-content.pdf” and “My Chapter-notes.pdf” in your Downloads directory.

Let me know if any steps in the above fail for you. I don’t own an Apple computer so I might well have missed something.