mirror of
https://github.com/squidfunk/mkdocs-material.git
synced 2024-12-18 10:25:58 +01:00
105 lines
3.4 KiB
Markdown
105 lines
3.4 KiB
Markdown
---
|
||
template: overrides/main.html
|
||
---
|
||
|
||
# Adding social links
|
||
|
||
The footer of your project documentation is a great place to add links to
|
||
websites or platforms you or your company are using as additional marketing
|
||
channels, e.g. :fontawesome-brands-medium:{: style="color: #00AB6C" },
|
||
:fontawesome-brands-twitter:{: style="color: #1DA1F2" } or
|
||
:fontawesome-brands-facebook:{: style="color: #4267B2" }, which can be
|
||
configured via `mkdocs.yml`.
|
||
|
||
## Configuration
|
||
|
||
### Social links
|
||
|
||
[:octicons-file-code-24: Source][1] ·
|
||
:octicons-milestone-24: Default: _none_
|
||
|
||
All _social links_ are rendered next to the copyright information as part of the
|
||
footer of your project documentation. Add a list of social links in `mkdocs.yml`
|
||
with:
|
||
|
||
``` yaml
|
||
extra:
|
||
social:
|
||
- icon: fontawesome/brands/twitter
|
||
link: https://twitter.com/squidfunk
|
||
```
|
||
|
||
For each entry, the following fields are available:
|
||
|
||
`icon`{: #icon }
|
||
|
||
: :octicons-milestone-24: Default: _none_ · :octicons-alert-24: Required –
|
||
This field must point to a valid icon path referencing [any icon bundled
|
||
with the theme][2], or the build will not succeed. Some popular choices:
|
||
|
||
* :fontawesome-brands-behance: – `fontawesome/brands/behance`
|
||
* :fontawesome-brands-docker: – `fontawesome/brands/docker`
|
||
* :fontawesome-brands-github: – `fontawesome/brands/github`
|
||
* :fontawesome-brands-instagram: – `fontawesome/brands/instagram`
|
||
* :fontawesome-brands-linkedin: – `fontawesome/brands/linkedin`
|
||
* :fontawesome-brands-medium: – `fontawesome/brands/medium`
|
||
* :fontawesome-brands-pied-piper-alt: – `fontawesome/brands/pied-piper-alt`
|
||
* :fontawesome-brands-product-hunt: – `fontawesome/brands/product-hunt`
|
||
* :fontawesome-brands-slack: – `fontawesome/brands/slack`
|
||
* :fontawesome-brands-twitter: – `fontawesome/brands/twitter`
|
||
|
||
[1]: https://github.com/squidfunk/mkdocs-material/blob/master/src/partials/social.html
|
||
[2]: https://github.com/squidfunk/mkdocs-material/tree/master/material/.icons
|
||
|
||
`link`{: #link }
|
||
|
||
: :octicons-milestone-24: Default: _none_ · :octicons-alert-24: Required –
|
||
This field must contain a valid relative or absolute URL including the URI
|
||
scheme. All URI schemes are supported, including `mailto` and `bitcoin`:
|
||
|
||
=== "Twitter"
|
||
|
||
``` yaml
|
||
extra:
|
||
social:
|
||
- icon: fontawesome/brands/twitter
|
||
link: https://twitter.com/squidfunk
|
||
```
|
||
|
||
=== "Email address"
|
||
|
||
``` yaml
|
||
extra:
|
||
social:
|
||
- icon: fontawesome/solid/paper-plane
|
||
link: mailto:<email-address>
|
||
```
|
||
|
||
`name`{: #name }
|
||
|
||
: :octicons-milestone-24: Default: _domain name from_ `link`_, if available_ –
|
||
This field is used as the link's `title` attribute and can be set to a
|
||
discernable name to improve accessibility:
|
||
|
||
``` yaml
|
||
extra:
|
||
social:
|
||
- icon: fontawesome/brands/twitter
|
||
link: https://twitter.com/squidfunk
|
||
name: squidfunk on Twitter
|
||
```
|
||
|
||
## Customization
|
||
|
||
### Custom icons
|
||
|
||
[:octicons-file-code-24: Source][2] ·
|
||
:octicons-mortar-board-24: Difficulty: _moderate_
|
||
|
||
The social links feature uses the standard [icon integration][3] of Material for
|
||
MkDocs. If you want to use custom icons, follow the guide explaining how to
|
||
add [additional icons][4].
|
||
|
||
[3]: changing-the-logo-and-icons.md#icons
|
||
[4]: changing-the-logo-and-icons.md#additional-icons
|