Awesome
Documentation for TriplyDB
This repository contains the TriplyDB documentation files. These files are used by the Triply documentation website over at https://docs.triply.cc/.
Covered products
This repository includes documentation for the following Triply products:
<dl> <dt>TriplyDB</dt> <dd>An integrated linked data environment for publishing and using linked data knowledge graphs.</dd> <dt>TriplyETL</dt> <dd>A library that is optimized for building production-grade linked data pipelines.</dd> <dt>TriplyDB.js</dt> <dd>A library for automating tasks in TriplyDB instances and for building applications that tap into a linked data knowledge graph.</dd> </dl>Contributing
- Feel free to open issues with questions about the documentation.
- Feel free to create pull requests with adjustments or additions that you believe to be valuable.
Available markdown
You are able to use GitHub Flavored Markdown. As well as the following extensions
Custom ID headers: By default ID's will be created from the content of a header, allowing deep linking to them using the #hash part of a URL.
## My Header
This will result in link http://docs.triply.cc/path-to-file/#my-header
.
Using the following syntax you are able to assign custom id's to headers if you do not want the default ID:
## My Header {: #my-custom-header-id}
This will result in link http://docs.triply.cc/path-to-file/#my-custom-header-id
.
Guideline for authors
- Always start your page with a heading of level 1 (1 hashsign)
- Subheadings of level 2 (2 hashsigns) will appear as submenu on that page
- Level 1 links in the menu that only contain subpage will not be clickable until a developer creates a mapping in
docs/js/triply.js
Installation
This website uses MkDocs to convert Markdown to HTML so the documentation can be viewed in a web browser. Follow the instructions on their website to install MkDocs.
Required plugins:
- To render
mermaid
you will need to install this plugin.
The following steps often work/suffice:
- Install Python and Pip.
- Run
pip install mkdocs
- Run
pip install mkdocs-mermaid2-plugin
- Run
pip install mkdocs-redirects
Building and running the Documentation website
After you have successfully installed MkDocs, you can run a local web server with the following command (run from the root of this repository):
mkdocs serve --strict
To build a static HTML website for deployment, run this command:
mkdocs build
This will generate the required HTML and CSS in a folder ./site
.
To publish this website, push your changes to the master branch. The live documentation site should be updated shortly after that. If there are any errors, you can find more details in the GitHub Actions.
Notes about syntax highlighting
This project uses highlightjs.org for rendering code blocks with syntax highlighting. This projects does not have support for Turtle/SPARQL by default. We use a custom build to provide syntax highlighting for these.
mkdir Highlight.js
cd Highlight.js
git clone https://github.com/highlightjs/highlight.js.git
git clone https://github.com/mightymax/highlightjs-turtle.git
cd highlight.js/src/languages
ln -s ../../../highlightjs-turtle/src/sparql.js
ln -s ../../../highlightjs-turtle/src/turtle.js
cd ../../
node tools/build.js turtle sparql typescript javascript
cp build/highlight.min.js <path-to-this-repo>/js
cp build/demo/styles/intellij-light.css <path-to-this-repo>/css