A handy way to create many links across multiple HTML files
Usage:
- Create a tab-delimited text file in the following format:
file-to-link-from\ttext to link from\tfile-to-link-to\t<html>to link to\nexample:
POSBActSpa02_chapter02.xhtml I. Los grandes días de expectación POSBActSpa02_chapter03.xhtml <h1><span class="label">División I</span>Los Grandes Días de Expectación
- Save the file in your EPUBs 'META-INF' folder in UTF-8 format with Unix line breaks (
\n) - Install Linker globally after cloning the repo by entering
npm install -gfrom within the linker directory - Navigate in a terminal to your EPUB directory
- Run
linker file.txt 1where 'file.txt' is the file you created in META-INF and '1' is the number you want to start with for incrementing ids
Behavior:
-
Linker will surround the first occurrence of 'text to link from' in 'file-to-link-from' with an
<a>tag whose href is file-to-link-to with a unique id:#ref[num]e.g.<a href="POSBActSpa02_chapter03.xhtml#ref1">I. Los grandes días de expectación</a>This could give you less than satisfactory results if there are multiple occurrences of 'text to link from' in 'file-to-link-from' -
Linker will add an id to the first HTML element of the first occurrence of 'to link to' in 'file-to-link-to' e.g.
<h1 id="ref1"><span class="label">División I</span>Los Grandes Días de ExpectaciónAgain, if there are multiple occurrences of 'to link to' Linker will always tag the first exact match
-Peter Turner