docs(user): add slug + tips on how to identify pages without one easily

This commit is contained in:
Elian Doran
2025-10-30 08:03:09 +02:00
parent 444e103047
commit f944c6d8e2
6 changed files with 362 additions and 317 deletions

View File

@@ -15,19 +15,26 @@
"type": "text",
"mime": "text/html",
"attributes": [
{
"type": "relation",
"name": "internalLink",
"value": "s3YCWHBfmYuM",
"isInheritable": false,
"position": 10
},
{
"type": "relation",
"name": "internalLink",
"value": "BFs8mudNFgCS",
"isInheritable": false,
"position": 60
"position": 20
},
{
"type": "relation",
"name": "internalLink",
"value": "GTwFsgaA0lCt",
"isInheritable": false,
"position": 70
"position": 30
},
{
"type": "label",
@@ -42,13 +49,6 @@
"value": "promoted,alias=Slug,single,text",
"isInheritable": true,
"position": 20
},
{
"type": "relation",
"name": "internalLink",
"value": "s3YCWHBfmYuM",
"isInheritable": false,
"position": 80
}
],
"format": "markdown",
@@ -3083,7 +3083,15 @@
"isExpanded": false,
"type": "text",
"mime": "text/html",
"attributes": [],
"attributes": [
{
"type": "label",
"name": "shareAlias",
"value": "quick-edit",
"isInheritable": false,
"position": 30
}
],
"format": "markdown",
"dataFileName": "Quick edit.md",
"attachments": [
@@ -5313,6 +5321,20 @@
"isInheritable": false,
"position": 30
},
{
"type": "relation",
"name": "internalLink",
"value": "yeEaYqosGLSh",
"isInheritable": false,
"position": 40
},
{
"type": "relation",
"name": "internalLink",
"value": "cbkrhQjrkKrh",
"isInheritable": false,
"position": 50
},
{
"type": "label",
"name": "shareAlias",
@@ -5326,20 +5348,6 @@
"value": "bx bx-run",
"isInheritable": false,
"position": 40
},
{
"type": "relation",
"name": "internalLink",
"value": "yeEaYqosGLSh",
"isInheritable": false,
"position": 50
},
{
"type": "relation",
"name": "internalLink",
"value": "cbkrhQjrkKrh",
"isInheritable": false,
"position": 60
}
],
"format": "markdown",
@@ -11544,6 +11552,20 @@
"value": "bx bx-share-alt",
"isInheritable": false,
"position": 30
},
{
"type": "relation",
"name": "internalLink",
"value": "eIg8jdvaoNNd",
"isInheritable": false,
"position": 200
},
{
"type": "relation",
"name": "internalLink",
"value": "OFXdgB2nNk1F",
"isInheritable": false,
"position": 210
}
],
"format": "markdown",
@@ -11634,7 +11656,7 @@
"name": "internalLink",
"value": "R9pX4DGra2Vt",
"isInheritable": false,
"position": 30
"position": 10
},
{
"type": "label",
@@ -11642,6 +11664,13 @@
"value": "bx bxs-file-html",
"isInheritable": false,
"position": 40
},
{
"type": "label",
"name": "shareAlias",
"value": "static-html",
"isInheritable": false,
"position": 50
}
],
"format": "markdown",

View File

@@ -106,6 +106,10 @@ Shared notes typically have URLs like `http://domain.tld/share/knvU8aJy4dJ7`, wh
1. Ensure that aliases are unique.
2. Using slashes (`/`) within aliases to create subpaths is not supported.
> [!TIP]
> * To easily identify pages that don't have a share alias, run a <a class="reference-link" href="../Basic%20Concepts%20and%20Features/Navigation/Search.md">Search</a> with `#!shareAlias`.
> * To be able to enter the share alias faster, consider using <a class="reference-link" href="Attributes/Promoted%20Attributes.md">Promoted Attributes</a> (for example `#label:shareAlias(inheritable)="promoted,alias=Slug,single,text"`).
### Setting a custom favicon
To customize the favicon for your shared pages, create a relation `~shareFavicon` pointing to a file note containing the favicon (e.g., in `.ico` format).

View File

@@ -38,4 +38,4 @@ Once installed simply:
1. Extract the exported .zip file.
2. Inside the extracted directory, run `http-server`.
3. Access the indicated address (e.g. http://localhost:8080).
3. Access the indicated address (e.g. [http://localhost:8080](http://localhost:8080)).