https://github.com/duendesoftware/docs.duendesoftware.com
Documentation for our Products
https://github.com/duendesoftware/docs.duendesoftware.com
Last synced: about 1 year ago
JSON representation
Documentation for our Products
- Host: GitHub
- URL: https://github.com/duendesoftware/docs.duendesoftware.com
- Owner: DuendeSoftware
- Created: 2020-09-10T13:52:12.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2025-03-27T14:51:01.000Z (about 1 year ago)
- Last Synced: 2025-03-28T06:08:11.500Z (about 1 year ago)
- Language: CSS
- Homepage: https://docs.duendesoftware.com
- Size: 25.9 MB
- Stars: 29
- Watchers: 10
- Forks: 141
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# https://docs.duendesoftware.com
## Getting Started
You will need [**Hugo 0.140.2**](https://gohugo.io/) installed on your operating system and in the PATH.
See the [official Hugo documentation](https://gohugo.io/installation/) for OS-specific instructions.
## Running the Documentation Site(s)
You can use `npm run` to run the documentation site locally:
* `npm run v7` - http://localhost:1313/identityserver/v7/
* `npm run v6` - http://localhost:1313/identityserver/v6/
* `npm run foss` - http://localhost:1313/foss/
There are a few other options, explore them by running `npm run` from a terminal.
## Making a page redirect to somewhere else
There are two ways to restructure content:
* Internal (move content around in the current structure)
* External (move content outside the current structure)
### Internal restructuring
When doing internal restructuring, move the page to its new location and then update its frontmatter
to include the old location:
```yaml
---
title: Page title
aliases:
- "/old-path-to/content"
---
Page content goes here
```
This will generate the page at the new location, and put a redirect to it at the old location.
Note that the alias should not include the docs site prefix. To redirect `/identityserver/v7/example`,
use `/example` as the alias.
### External restructuring
When moving a page outside the structure, or you need a redirect to another location altogether,
you can keep the old page but replace its contents with just frontmatter - changing its type to `redirect`
and setting the redirect `target`:
```yaml
---
type: redirect
target: https://duckduckgo.com
---
```
This will remove the old page from the navigation structure, but keeps the URL around
with a redirect to the new location.