mirror of
https://github.com/hasura/graphql-engine.git
synced 2024-12-16 01:44:03 +03:00
45 lines
1.2 KiB
Plaintext
45 lines
1.2 KiB
Plaintext
|
---
|
||
|
title: Links
|
||
|
description: Style for links in documentation
|
||
|
keywords:
|
||
|
- hasura
|
||
|
- style
|
||
|
- links
|
||
|
---
|
||
|
|
||
|
# Links
|
||
|
|
||
|
#### Internal links
|
||
|
|
||
|
When linking to other docs pages, use _root relative file paths_ (`/schema/postgres/tables.mdx`) rather than _relative
|
||
|
links_ (`../../path/to/file.mdx`) in order to avoid broken links. Why? when files are moved around, we just need to
|
||
|
replace old path with new path - no relative `../../../` resolution required.
|
||
|
|
||
|
Please read the [Links](/docusaurus-mdx-guide/links.mdx) section for more details on how to work with Links.
|
||
|
|
||
|
An example:
|
||
|
|
||
|
```
|
||
|
[Postgres tables](/schema/postgres/tables.mdx)
|
||
|
```
|
||
|
|
||
|
In this example, `Postgres tables` is the link text, and `/schema/postgres/tables.mdx` is the file path which will be
|
||
|
resolved as link by docusaurus.
|
||
|
|
||
|
#### External links
|
||
|
|
||
|
External links are no different in syntax, replace the file paths with external links and that's it.
|
||
|
|
||
|
An example:
|
||
|
|
||
|
`[Google](https://www.google.com/)` [Google](https://www.google.com/)
|
||
|
|
||
|
|
||
|
:::info Note
|
||
|
|
||
|
If you link to an external resource, make sure to link to the most current version of the same, e.g.
|
||
|
`https://www.postgresql.org/docs/current/intro-whatis.html` rather than
|
||
|
`https://www.postgresql.org/docs/9.6/intro-whatis.html`.
|
||
|
|
||
|
:::
|