Usando Mkdocs Material¶
Atalhos¶
- Well-designed search interface accessible through hotkeys (F or S), intelligent grouping of search results, search term highlighting and lazy loading.
Favicon¶
Default:
assets/images/favicon.png
Imagem¶
Atenção:
Sem Link
Link¶
For detailed instructions see the getting started guide.
Headings¶
The 3rd level¶
The 4th level¶
The 5th level¶
The 6th level¶
Headings with secondary text¶
The 3rd level with secondary text¶
The 4th level with secondary text¶
The 5th level with secondary text¶
The 6th level with secondary text¶
Blockquotes¶
Morbi eget dapibus felis. Vivamus venenatis porttitor tortor sit amet rutrum. Pellentesque aliquet quam enim, eu volutpat urna rutrum a. Nam vehicula nunc mauris, a ultricies libero efficitur sed. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed molestie imperdiet consectetur.
Other content blocks¶
Vestibulum vitae orci quis ante viverra ultricies ut eget turpis. Sed eu lectus dapibus, eleifend nulla varius, lobortis turpis. In ac hendrerit nisl, sit amet laoreet nibh.
var _extends = function(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { target[key] = source[key]; } } return target; };Praesent at
return target
, sodales nibh vel, tempor felis. Fusce vel lacinia lacus. Suspendisse rhoncus nunc non nisi iaculis ultrices. Donec consectetur mauris non neque imperdiet, eget volutpat libero.
Lists¶
Unordered lists¶
-
Sed sagittis eleifend rutrum. Donec vitae suscipit est. Nullam tempus tellus non sem sollicitudin, quis rutrum leo facilisis. Nulla tempor lobortis orci, at elementum urna sodales vitae. In in vehicula nulla, quis ornare libero.
- Duis mollis est eget nibh volutpat, fermentum aliquet dui mollis.
- Nam vulputate tincidunt fringilla.
- Nullam dignissim ultrices urna non auctor.
-
Aliquam metus eros, pretium sed nulla venenatis, faucibus auctor ex. Proin ut eros sed sapien ullamcorper consequat. Nunc ligula ante, fringilla at aliquam ac, aliquet sed mauris.
-
Nulla et rhoncus turpis. Mauris ultricies elementum leo. Duis efficitur accumsan nibh eu mattis. Vivamus tempus velit eros, porttitor placerat nibh lacinia sed. Aenean in finibus diam.
Ordered lists¶
-
Integer vehicula feugiat magna, a mollis tellus. Nam mollis ex ante, quis elementum eros tempor rutrum. Aenean efficitur lobortis lacinia. Nulla consectetur feugiat sodales.
-
Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Aliquam ornare feugiat quam et egestas. Nunc id erat et quam pellentesque lacinia eu vel odio.
-
Vivamus venenatis porttitor tortor sit amet rutrum. Pellentesque aliquet quam enim, eu volutpat urna rutrum a. Nam vehicula nunc mauris, a ultricies libero efficitur sed.
- Mauris dictum mi lacus
- Ut sit amet placerat ante
- Suspendisse ac eros arcu
-
Morbi eget dapibus felis. Vivamus venenatis porttitor tortor sit amet rutrum. Pellentesque aliquet quam enim, eu volutpat urna rutrum a. Sed aliquet, neque at rutrum mollis, neque nisi tincidunt nibh.
-
Pellentesque eget
var _extends
ornare tellus, ut gravida mi.var _extends = function(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { target[key] = source[key]; } } return target; };
-
Definition lists¶
- Lorem ipsum dolor sit amet
-
Sed sagittis eleifend rutrum. Donec vitae suscipit est. Nullam tempus tellus non sem sollicitudin, quis rutrum leo facilisis. Nulla tempor lobortis orci, at elementum urna sodales vitae. In in vehicula nulla.
Duis mollis est eget nibh volutpat, fermentum aliquet dui mollis. Nam vulputate tincidunt fringilla. Nullam dignissim ultrices urna non auctor.
- Cras arcu libero
-
Aliquam metus eros, pretium sed nulla venenatis, faucibus auctor ex. Proin ut eros sed sapien ullamcorper consequat. Nunc ligula ante, fringilla at aliquam ac, aliquet sed mauris.
Code blocks¶
Inline¶
Morbi eget dapibus felis
. Vivamus venenatis porttitor
tortor sit amet
rutrum. Class aptent taciti sociosqu ad litora torquent per conubia nostra,
per inceptos himenaeos. Pellentesque aliquet quam enim
, eu volutpat urna
rutrum a.
Nam vehicula nunc return target
mauris, a ultricies libero efficitur
sed. Sed molestie imperdiet consectetur. Vivamus a pharetra leo. Pellentesque
eget ornare tellus, ut gravida mi. Fusce vel lacinia lacus.
Listing¶
1 2 3 4 5 6 7 8 9 | var _extends = function(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { target[key] = source[key]; } } return target; }; |
Horizontal rules¶
Aenean in finibus diam. Duis mollis est eget nibh volutpat, fermentum aliquet dui mollis. Nam vulputate tincidunt fringilla. Nullam dignissim ultrices urna non auctor.
Anotações¶
Why is there an edit button at the top of every article?
If the repo_url
is set to a GitHub or BitBucket repository, and the
repo_name
is set to GitHub or BitBucket (implied by default), an
edit button will appear at the top of every article. This is the automatic
behavior that MkDocs implements. See the MkDocs documentation on more
guidance regarding the edit_uri
attribute, which defines whether the edit
button is shown or not.
Installation on macOS
When you're running the pre-installed version of Python on macOS, pip
tries to install packages in a folder for which your user might not have
the adequate permissions. There are two possible solutions for this:
-
Installing in user space (recommended): Provide the
--user
flag to the install command andpip
will install the package in a user-site location. This is the recommended way. -
Switching to a homebrewed Python: Upgrade your Python installation to a self-contained solution by installing Python with Homebrew. This should eliminate a lot of problems you may be having with
pip
.
Error: unrecognized theme 'material'
If you run into this error, the most common reason is that you installed
MkDocs through some package manager (e.g. Homebrew or apt-get
) and the
Material theme through pip
, so both packages end up in different
locations. MkDocs only checks its install location for themes.
Search language support for Chinese
[lunr-languages][18] currently doesn't include a stemmer for Chinese or other Asian languages, but uses the Japanese stemmer, as some users reported pretty decent results.
Primary colors¶
Default:
indigo
Click on a tile to change the primary color of the theme:
Accent colors¶
Default:
indigo
Click on a tile to change the accent color of the theme:
Font family¶
Default:
Roboto
andRoboto Mono
By default the Roboto font family is included with the theme, specifically
the regular sans-serif type for text and the monospaced
type for code. Both
fonts are loaded from Google Fonts and can be changed to other fonts,
like for example the Ubuntu font family:
theme: font: text: 'Ubuntu' code: 'Ubuntu Mono'
The text font will be loaded in weights 400 and 700, the monospaced
font
in regular weight. If you want to load fonts from other destinations or don't
want to use the Google Fonts loading magic, just set font
to false
:
theme: font: false
Data tables¶
Sollicitudo / Pellentesi | consectetur | adipiscing | elit | arcu | sed |
---|---|---|---|---|---|
Vivamus a pharetra | yes | yes | yes | yes | yes |
Ornare viverra ex | yes | yes | yes | yes | yes |
Mauris a ullamcorper | yes | yes | partial | yes | yes |
Nullam urna elit | yes | yes | yes | yes | yes |
Malesuada eget finibus | yes | yes | yes | yes | yes |
Ullamcorper | yes | yes | yes | yes | yes |
Vestibulum sodales | yes | - | yes | - | yes |
Pulvinar nisl | yes | yes | yes | - | - |
Pharetra aliquet est | yes | yes | yes | yes | yes |
Sed suscipit | yes | yes | yes | yes | yes |
Orci non pretium | yes | partial | - | - | - |
Sed sagittis eleifend rutrum. Donec vitae suscipit est. Nullam tempus tellus non sem sollicitudin, quis rutrum leo facilisis. Nulla tempor lobortis orci, at elementum urna sodales vitae. In in vehicula nulla, quis ornare libero.
Left | Center | Right |
---|---|---|
Lorem | dolor | amet |
ipsum | sit |
Vestibulum vitae orci quis ante viverra ultricies ut eget turpis. Sed eu lectus dapibus, eleifend nulla varius, lobortis turpis. In ac hendrerit nisl, sit amet laoreet nibh.
Table | with colgroups (Pandoc) |
---|---|
Lorem | ipsum dolor sit amet. |
Sed sagittis | eleifend rutrum. Donec vitae suscipit est. |
Available language stemmers | |||
---|---|---|---|
da / Danish |
du / Dutch |
en / English |
fi / Finnish |
fr / French |
de / German |
hu / Hungarian |
it / Italian |
jp / Japanese |
no / Norwegian |
pt / Portugese |
ro / Romanian |
ru / Russian |
es / Spanish |
sv / Swedish |
tr / Turkish |