Get the files
- Either add as a dependency: npm i @cwrc/dtoc
- Or download: https://registry.npmjs.org/@cwrc/dtoc/-/dtoc-0.1.7.tgz
Copy files to a directory in your workspace
Initialize and provide a configuration object

<!DOCTYPE html>
<html>
	<head>
		<script type="text/javascript" src="./lib/ext/ext.js"></script>
		<script type="text/javascript" src="./lib/saxon/saxon.js"></script>
		<script type="module" src="./dtoc.min.js"></script>
		<link rel="stylesheet" type="text/css" href="./lib/ext/ext.css" />
		<link rel="stylesheet" type="text/css" href="./css/dtc.css" />
		<script src="https://kit.fontawesome.com/891f15ee2f.js" crossorigin="anonymous"></script>
		<link rel="preconnect" href="https://fonts.googleapis.com">
		<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
		<link href="https://fonts.googleapis.com/css2?family=Nunito:wght@300;400&family=Roboto+Slab:wght@300;400&display=swap" rel="stylesheet">
	</head>
	<body>
	<script type="text/javascript">
	window.dtocApp = new dtoc({
		"ignoreNamespace": true,
		"documents": "//front|//div[@type='chapter']|//div[@type='preface']|//div[@type='afterword']|//div[@type='contributors']",
		"documentTitle": "head/title",
		"documentAuthor": "docAuthor[1]",
		"documentImages": "graphic[@url]",
		"documentNotes": "note",
		"documentLinks": "ref[target^='http']",
		"indexDocument": "//div[@type='index']",
		"inputs": [
			"https://calincs.gitlab.io/cwrc/dtoc/dtoc-2.0/data/xml/sample.xml"
		]
	});
	</script>
	</body>
</html>

Configuration Object Details

An explanation of the properties in the configuration object.

Italicized properties are optional.

Name	Type	Details
dtocRootUrl	String	An URL specifying the location of the DToC files root. If not provided then `window.location` will be used.
inputs	Array	An array of URLs or Files
documents	String	The XPath for locating the document(s) within each XML file
documentContent	String	The XPath for locating the actual content within the document
documentTitle	String	The XPath for locating the document title
documentAuthor	String	The XPath for locating the document author
documentImages	String	The XPath for identifying images
documentNotes	String	The XPath for identifying notes
documentLinks	String	The XPath for identifying links
ignoreNamespace	Boolean	Whether to remove the root/default namespace prior to evaluating XPaths. Use to avoid having to use local-name() in XPaths.
editionTitle	String	The title of the edition
editionSubtitle	String	The subtitle of the edition
indexDocument	String	The XPath for locating the index document to use as the corpus index
curation	Object	An optional curation object. Can be used to customize the tags panel and the table of contents panel.
curation.markup	Array	An array of markup
curation.toc	Array	The table of contents

Keywords

xml

reader

FAQs

What is @cwrc/dtoc?

Is @cwrc/dtoc popular?

Is @cwrc/dtoc well maintained?

Package last updated on 13 Oct 2023

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install