Todar's Online Textbook of Bacteriology (archived August 2023)

# Archiving Todar's Online Textbook of Bacteriology This documentation outlines the steps to archive an online textbook for offline use. We'll be using various tools and techniques to achieve this. Follow these steps carefully: ## Step 1: Download Dependencies Before we begin, make sure you have the following dependencies installed on your system: - **base.css** - use this css to properly format. Add to the same directory where you will be using princexml Download from: [base.css](https://github.com/arp242/hello-css/blob/master/base.css) - **Prince XML Converter** Download from: [Prince XML](https://www.princexml.com/download/) Ensure that these dependencies are installed and ready to use. ## Step 2: Download the Website 1. Open your terminal. 2. Create a directory for the archived textbook and navigate to it using the following commands: ```shell mkdir todars cd todars ``` 3. Use `wget` to download the entire website with the necessary options: ```shell wget --recursive --no-clobber --page-requisites --html-extension --convert-links --restrict-file-names=windows --domains textbookofbacteriology.net --no-parent http://textbookofbacteriology.net// ``` This command will recursively download all the website content while preserving its structure. ## Step 3: Convert HTML to PDF Now that you have the website content, we will convert it to a PDF file using the Prince XML Converter. 1. Organize the HTML files in the desired order. **important: I sorted them manually using the table of contents as my reference** 2. Open your terminal and execute the following command, replacing `[paste html list here in order]` with the list of HTML files in the desired order: ```shell prince [paste html list here in order] --page-size="US-Folio" --page-margin="20mm" --style=base.css --media="screen" -o ~/combined_all4.pdf ``` This command will use Prince XML to convert the organized HTML files into a single PDF file named `combined_all4.pdf`. ## Step 4: Generate PDF Outlines To make navigating the PDF easier, you can generate outlines for the PDF using PDF Tocgen. 1. Download PDF Tocgen from its repository: [PDF Tocgen](https://github.com/Krasjet/pdf.tocgen). 2. Follow the installation instructions and Getting Started guide provided in the PDF Tocgen repository. 3. Once installed, use PDF Tocgen to generate outlines for your PDF: ```shell pdf.tocgen -i ~/combined_all4.pdf -o ~/combined_all4_with_outlines.pdf ``` This command will create a new PDF file named `combined_all4_with_outlines.pdf` with outlines for easy navigation.