From 7b533e665dfdeef8916d967eb0025edb46ce276f Mon Sep 17 00:00:00 2001 From: constantinos Date: Mon, 17 Jul 2023 19:05:56 +0300 Subject: [PATCH] added heading ids for internal links for consistency !publish! --- content/article/int-features.md | 6 +++--- content/article/int-library.md | 8 ++++---- content/article/int-management.md | 4 ++-- content/article/int-sandpoints.md | 8 ++++---- content/article/int-todo.md | 8 ++++---- 5 files changed, 17 insertions(+), 17 deletions(-) diff --git a/content/article/int-features.md b/content/article/int-features.md index dd4a8b0..b41b97b 100644 --- a/content/article/int-features.md +++ b/content/article/int-features.md @@ -17,9 +17,9 @@ abstract: | Here we can list feature requests and issues for *Sandpoints*, or for this project in general. After being discussed, issues and requests should be communicated to and discussed with the *Sandpoints* developers, ideally by filing an issue on the [Sandpoints repository](https://git.sandpoints.org/). -To contribute an issue or request make a new subheading within [feature requests](#feature-requests), and add date and contributor. Resolved issues should be moved to the [resolved](#resolved) section. +To contribute an issue or request make a new subheading within [feature requests](#requests), and add date and contributor. Resolved issues should be moved to the [resolved](#resolved) section. -# Feature requests +# Feature requests {#requests} ## Expose item publication date (urgent) @@ -88,7 +88,7 @@ Necessary metadata fields seem to get lost in the transfer, like: } ``` -# Resolved +# Resolved {#resolved} ## Add background to code blocks diff --git a/content/article/int-library.md b/content/article/int-library.md index f03ae4c..cd7538f 100644 --- a/content/article/int-library.md +++ b/content/article/int-library.md @@ -129,7 +129,7 @@ This will setup a new profile and also build a standalone web app of the library The profile should now be visible in `accorder configuration -s`. To edit elements of a profile configuration follow instructions in `accorder configuration --help`. -## Build a portable library +## Build a portable library {#build-lib} With accorder installed and a profile setup, to build a standalone web app of the library do: ``` @@ -140,7 +140,7 @@ This will generate a portable version of the Calibre library by adding in the li 1. a `BROWSE_LIBRARY.html` file, and 2. a folder titled `static` with necessary dependencies. -## Build library catalogue +## Build library catalogue {#build-catalog} To build a library catalogue that allows referencing library items from Sandpoints do: @@ -162,8 +162,8 @@ Note: The catalogue file can be opened and viewed with any text editor. It is fo # Deploy library To deploy a library firstly use accorder to -- [build a library standalone web app](#build-a-portable-library), and -- [build a library catalogue](#build-library-catalogue). +- [build a library standalone web app](#build-lib), and +- [build a library catalogue](#build-catalog). 1. Place the library catalogue at the folder `data/books/` of the project, as in: ``` diff --git a/content/article/int-management.md b/content/article/int-management.md index 920d223..6f8b918 100644 --- a/content/article/int-management.md +++ b/content/article/int-management.md @@ -30,7 +30,7 @@ Thus, with the infrastructure in place, no programming is needed To manage the site you first need to install: 1. [Git][] -- version control system. -2. [Hugo][] -- a static website builder ([see instruction below](#install-and-upgrade-hugo)). +2. [Hugo][] -- a static website builder ([see instructions below](#get-hugo)). 3. It's recommended to install the [Go Language][]. To manage the site you need the following tools: @@ -41,7 +41,7 @@ To manage the site you need the following tools: ## Library management tools Library management requires Calibre, Accorder, and Zotero. For detailed instructions see ![Library management](article:int-library). -## Install and upgrade Hugo +## Install and upgrade Hugo {#get-hugo} To install [Hugo][] for your system see [Hugo installation guide] -- Hugo is installed via a package manager, e.g. *Homebrew* for macOS or *choco* for Windows. diff --git a/content/article/int-sandpoints.md b/content/article/int-sandpoints.md index 36e9bb8..7c32e99 100644 --- a/content/article/int-sandpoints.md +++ b/content/article/int-sandpoints.md @@ -51,7 +51,7 @@ This project features the following content types (and subdirectories): - `contributor` - `print` -# Ontology +# Ontology {#ontology} Sandpoints supports a triadic hierarchy. This follows that content is organized, or parented according to a tree structure with a depth of three (entities). This project follows the scheme `journal>issue>article` (other examples to visualize this content are `book>chapter>section`, and `ship>deck>room`). @@ -102,13 +102,13 @@ For parenting and associating items see the ![Content creation guide](article:in *Sandpoints* projects feature a [sitemap](/), that lists all published content (all content that is not marked as draft). The sitemap is at the root URL of any given project. -# Backlinks +# Backlinks {#backlinks} The concept of backlinks was described in early speculations that informed hypertext (i.e. by Vannevar Bush and later Ted Nelson), but were not implemented the WWW. According to these ideas, hyperlinks are bi-directional, which follows that a hyperlink is visible both in the document that features a link *and also* at the target document where the link is pointing to. The latter aspect is a backlink. By this scheme, any document knows which other documents point to it. The same concept is used by search engine algorithms, such as 'page rank' by Google, that function by creating an index of how many webpages link to a specific target website -- or how many backlinks a given webpage has. -*Sandpoints* allows backlinks for selected items. These can be set at the config file, at the `sandpointsMentionedIn` array (see [Sandpoints config file](#sandpoints-config-file)). +*Sandpoints* allows backlinks for selected items. These can be set at the config file, at the `sandpointsMentionedIn` array (see [Sandpoints config file](#sandpoints-config)). ``` @@ -150,7 +150,7 @@ The root folder of the project contains the following files and folders. | `PUBLISH.trigger.md` | git hook for automatically building the website upon certain commit messages | `readme.md` | standard Git repository readme file. -# Sandpoints config file +# Sandpoints config file {#sandpoints-config} Each Sandpoints project has a TOML config file at: ``` diff --git a/content/article/int-todo.md b/content/article/int-todo.md index 9f172e8..468807e 100644 --- a/content/article/int-todo.md +++ b/content/article/int-todo.md @@ -12,7 +12,7 @@ keywords: # To-Do list 1. [ ] Agree on and draft a mission statement. -2. [ ] Figure out editorial board (see [Potential editorial pool](#potential-editorial-pool)). +2. [ ] Figure out editorial board (see [Potential editorial pool](#ed-pool)). 3. [ ] Submissions 1. [ ] Open to submissions anytime, or with open calls only? 2. [ ] Submission template. @@ -32,10 +32,10 @@ keywords: 10. [ ] Establish GitHub account for: 1. sharing tools 2. forking repositories submitted as research -11. Create a Zotero translator (almost ready; see [translator](#create-a-zotero-translator)). +11. Create a Zotero translator (almost ready; see [translator](#translator)). -# Potential editorial pool +# Potential editorial pool {#ed-pool} - Stefano Gualeni - Konstantinos Dimopoulos (videogame urbanist, consultant, game designer, director and coordinator of the Game Design program at SAE Athens). - Eric Zimmerman @@ -43,7 +43,7 @@ keywords: # Other ToDos -## Create a Zotero Translator +## Create a Zotero Translator {#translator} > Write a Zotero Translator to scrape reference metadata from entries of this site.