search

OSTP / PhysicsArtofModelling

First year calculus-based textbook
19 stars 10 forks source link

How to compile the documents? #315

Open ofenerci opened 5 years ago

ofenerci commented 5 years ago

Hello, It is pleasure for me to read the Physics Art of Modelling. As a high school physics teacher, I can withdraw many sections suitable for my students. I would like to translate the book into Turkish but I was not able to compile the document. There are some issues with figures and some macros. ( I am using Debian Linux and TeXLive 2019 distribution.)

I wonder you could include some instructions to how to compile with LaTeX. (Which LaTeX packages, etc.) This could ease for people who would like to translate the book( I hope you don't revoke the GNU Free Licence).

Thanks again this for monumental work

ryanmartinneutrino commented 5 years ago

Hi, I'm glad to hear that this is useful to you! First, I only just updated the final version yesterday, so if you're working off an old version, get the update.

In terms of the license, it's no longer GPL but instead, CC-BY-SA, which is effectively the same as GPL v3 (but more adapted for a book), so feel free to re-use, re-mix, and adapt as you please.

For compilation, I've been doing it on Windows (I know...), using the TexMaker editor and the MikTek version of latex. It needs to be compiled with pdflatex. I find that MikTex will correctly install the missing packages.

[Update] I've had a look on Linux, and indeed, Windows ignored some capital letters in the paths that were wrong for a couple of figures. There was also an issue with compiling some of the circuits (the joys of wrangling circuit tikz). I've now fixed these, so the current version of master should compile. I tried on Ubuntu 16.04 after installing texlive-full as an apt package.

Note that the packages you need are listed in BuildingModelsToDescribeOurWorld.tex and TextbookPreamble.tex, if you don't want to install texlive-full.

Thank you so much for pointing this issue out - we want to make it easy to compile! Let me know when we include a subfolder with the Turkish translation :-)