Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/checkly/docs.checklyhq.com
Checkly docs
https://github.com/checkly/docs.checklyhq.com
hugo website
Last synced: 6 days ago
JSON representation
Checkly docs
- Host: GitHub
- URL: https://github.com/checkly/docs.checklyhq.com
- Owner: checkly
- License: mit
- Created: 2021-04-14T14:02:31.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-16T19:18:23.000Z (7 days ago)
- Last Synced: 2024-12-17T09:49:55.422Z (6 days ago)
- Topics: hugo, website
- Language: SCSS
- Homepage: https://checklyhq.com
- Size: 232 MB
- Stars: 56
- Watchers: 22
- Forks: 36
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
## Run Locally
```bash
$ npm install
$ npm start
$ npm run start:api
```
## Build & Deploy
```bash
$ npm run build
$ npm run deploy
```
> Push to any branch will generate deployment preview via Vercel
> Push to `main` will automatically deploy to production via Vercel
## Algolia Search
This is done automatically through a github action, see `.github/worksflows/algolia-docsearch.yml`.
## Docs, Learn & Guides
Docs, Learn & Guides sections are open to contributions. If you find a mistake, or you think that something could be improved, please open a PR 🙂
- Docs: `./site/content/docs`
- Learn: `./site/content/learn`
- Guides: `./site/content/guides`
## Markdown extensions
### Fancy fenced code blocks with title
You can make fancy fenced code blocks as follows. We recognize any typescript and javascript code blocks and
add a nice logo to them.
````markdown
```ts {title="src/index.ts"}
console.log('hello world')
```
````
You can also highlight certain lines in the code block by adding a `hl_lines` attribute to the code block.
````markdown
```ts {title="src/index.ts", hl_lines=[2]}
console.log('hello world')
console.log('this will be highlighted')
console.log('goodbey world')
```
````
### Alerts
We removed all the custom Hugo shortcodes and replaced them with markdown alerts. You can use the following types:
- `[!NOTE]` (default, same as not specifying any type)
- `[!WARNING]`
- `[!CLI]`
````markdown
> This is a default note / info alert.
> [!NOTE]
> This is the same as the default note / info alert, just more explicit.
> [!WARNING]
> This is a warning.
> [!CLI]
> This adds a CLI tip!
````
## Blog
Do you want to share your use case and experience using Checkly with your product? Become a guest author.
Reach us at [[email protected]](mailto:[email protected])
## License
[MIT](https://github.com/checkly/jamstack-deploy/blob/master/LICENSE)