mirror of
https://gitee.com/docsifyjs/docsify.git
synced 2024-12-05 05:29:12 +08:00
2e00f4c993
* feat: ignore to compiled link, fixed #203 * feat: add noCompileLinks, fixed #203 * fix: remove test code
362 lines
6.5 KiB
Markdown
362 lines
6.5 KiB
Markdown
# Einstellungen
|
|
|
|
**docsify** unterstützt zwei verschiedene Arten, um die Einstellungen anzupassen. Du kannst das `window.$docsify` anpassen, oder die Einstellungen über das script tag im `data-*` Attribut vornehmen.
|
|
|
|
```html
|
|
<!-- über $docsify -->
|
|
<script>
|
|
window.$docsify = {
|
|
repo: 'QingWei-Li/docsify',
|
|
maxLevel: 3,
|
|
coverpage: true
|
|
}
|
|
</script>
|
|
|
|
<!-- oder data-* -->
|
|
<script
|
|
src="//unpkg.com/docsify"
|
|
data-repo="QingWei-Li/docsify"
|
|
data-max-level="3"
|
|
data-coverpage>
|
|
</script>
|
|
```
|
|
|
|
Beide Arten sind miteinander kompatibel, wobei die erste jedoch empfohlen wird. Sie ist deutlicher und kann in einer separaten Datei geführt werden.
|
|
|
|
!> Innerhalb des `window.$docsfiy` sollten die Optionen mit camelCase geschrieben werden.
|
|
|
|
## el
|
|
|
|
- Typ: `String`
|
|
- Standard: `#app`
|
|
|
|
Das DOM Element kann bei der Initialisierung gesetzt werden. Es kann ein CSS selector string oder ein richtiges HTMLElement sein.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
el: '#app'
|
|
}
|
|
```
|
|
|
|
## repo
|
|
|
|
- Typ: `String`
|
|
- Standard: `null`
|
|
|
|
Verwende die repository URL oder eine Zeichenfolge aus `Benutzername/repo`, um das [GitHub Corner](http://tholman.com/github-corners/) widget in die obere rechte Ecke der Seite zu implementieren.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
repo: 'QingWei-Li/docsify',
|
|
// oder
|
|
repo: 'https://github.com/QingWei-Li/docsify/'
|
|
}
|
|
```
|
|
|
|
## max-level
|
|
|
|
- Typ: `Number`
|
|
- Standard: `6`
|
|
|
|
Maximale Anzahl der Inhaltsübersichtebenen.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
maxLevel: 4
|
|
}
|
|
```
|
|
|
|
## load-navbar
|
|
|
|
- Typ: `Boolean|String`
|
|
- Standard: `false`
|
|
|
|
Lädt die Navigationsleiste von der Markdown Datei `_navbar.md` falls **true**, oder vom gewählten Pfad.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
// lade von _navbar.md
|
|
loadNavbar: true,
|
|
|
|
// lade von nav.md
|
|
loadNavbar: 'nav.md'
|
|
}
|
|
```
|
|
|
|
## load-sidebar
|
|
|
|
- Typ: `Boolean|String`
|
|
- Standard: `false`
|
|
|
|
Lädt das seitliche Inhaltsverzeichnis von der Markdown Datei `_sidebar.md` falls **true**, oder vom gewählten Pfad.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
// lade von _sidebar.md
|
|
loadSidebar: true,
|
|
|
|
// lade von summary.md
|
|
loadSidebar: 'summary.md'
|
|
}
|
|
```
|
|
|
|
## sub-max-level
|
|
|
|
- Typ: `Number`
|
|
- Standard: `0`
|
|
|
|
Wähle die maximale Anzahl der Unterpunkte pro Datei in der Inhaltsübersicht.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
subMaxLevel: 2
|
|
}
|
|
```
|
|
|
|
## auto2top
|
|
|
|
- Typ: `Boolean`
|
|
- Standard: `false`
|
|
|
|
Scrolle zum Anfang der Seite, wenn die Route gewechselt wird.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
auto2top: true
|
|
}
|
|
```
|
|
|
|
## homepage
|
|
|
|
- Typ: `String`
|
|
- Standard: `README.md`
|
|
|
|
`README.md` in deinem Ordner für die Dokumentation wird als Startseite für deine Webseite gesetzt, aber manchmal musst du das vielleicht ändern.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
// Wähle /home.md
|
|
homepage: 'home.md',
|
|
|
|
// Oder verwende das README in deinem repo
|
|
homepage: 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/README.md'
|
|
}
|
|
```
|
|
|
|
## base-path
|
|
|
|
- Typ: `String`
|
|
|
|
Der Basispfad der Webseite. Du kannst einen anderen Ordner wählen, oder eine andere Domain.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
basePath: '/path/',
|
|
|
|
// Lade die Dateien von einer anderen Domain
|
|
basePath: 'https://docsify.js.org/',
|
|
|
|
// Oder lade Dateien von einem anderen repo
|
|
basePath: 'https://raw.githubusercontent.com/ryanmcdermott/clean-code-javascript/master/'
|
|
}
|
|
```
|
|
|
|
## coverpage
|
|
|
|
- Typ: `Boolean|String`
|
|
- Standard: `false`
|
|
|
|
Aktiviere das [Titelseitenfeature](de-de/cover.md). Falls `true`, wird sie von `_coverpage.md` geladen.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
coverpage: true,
|
|
|
|
// Anderer Dateiname
|
|
coverpage: 'cover.md'
|
|
}
|
|
```
|
|
|
|
## name
|
|
|
|
- Typ: `String`
|
|
|
|
Webseitenname, wie er in der Inhaltsübersicht in der Seitenleiste angezeigt wird.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
name: 'docsify'
|
|
}
|
|
```
|
|
|
|
## name-link
|
|
|
|
- Typ: `String`
|
|
- Standard: `window.location.pathname`
|
|
|
|
Der Name der Links.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
nameLink: '/',
|
|
|
|
// Für jede Route
|
|
nameLink: {
|
|
'/zh-cn/': '/zh-cn/',
|
|
'/': '/'
|
|
}
|
|
}
|
|
```
|
|
|
|
## markdown
|
|
|
|
- Typ: `Function`
|
|
|
|
Siehe [Markdown Konfiguration](de-de/markdown.md).
|
|
|
|
```js
|
|
window.$docsify = {
|
|
// Objekt
|
|
markdown: {
|
|
smartypants: true,
|
|
renderer: {
|
|
link: function() {
|
|
// ...
|
|
}
|
|
}
|
|
},
|
|
|
|
// Funktion
|
|
markdown: function (marked, renderer) {
|
|
// ...
|
|
return marked
|
|
}
|
|
}
|
|
```
|
|
|
|
## theme-color
|
|
|
|
- Typ: `String`
|
|
|
|
Passe die Farbe der Themen an. Verwende [CSS3 Variablen](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_variables) und polyfill in älteren Browsern.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
themeColor: '#3F51B5'
|
|
}
|
|
```
|
|
|
|
## alias
|
|
|
|
- Typ: `Object`
|
|
|
|
Verwende alternative Routen. Du kannst sie ungehindert anpassen. Supports RegExp.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
alias: {
|
|
'/foo/(+*)': '/bar/$1', // supports regexp
|
|
'/zh-cn/changelog': '/changelog',
|
|
'/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG'
|
|
}
|
|
}
|
|
```
|
|
|
|
## auto-header
|
|
|
|
- Typ: `Boolean`
|
|
|
|
Sollten `loadSidebar` und `autoHeader` beide aktiviert sein, setze einen Header vor die Seite in jedem Link in `_sidebar.md`, bevor sie in HTML umgewandelt wird. Vergleiche [#78](https://github.com/QingWei-Li/docsify/issues/78).
|
|
|
|
```js
|
|
window.$docsify = {
|
|
loadSidebar: true,
|
|
autoHeader: true
|
|
}
|
|
```
|
|
|
|
## execute-script
|
|
|
|
- Typ: `Boolean`
|
|
|
|
Führe das Skript auf der Seite aus. Analysiere nur das erste script tag ([demo](de-de/themes.md)). Sollte Vue verwendet sein, wird es in der Standardeinstellung ausgeführt.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
executeScript: true
|
|
}
|
|
```
|
|
|
|
```markdown
|
|
## Dies ist ein Test
|
|
|
|
<script>
|
|
console.log(2333)
|
|
</script>
|
|
```
|
|
|
|
?> Nehme zur Kenntnis, dass, solltest du ein externes Skript ausführen, z.B. ein eingebettete jsfiddle demo, du sicher gehen solltest, das [external-script](de-de/plugins.md?id=external-script) plugin zu verwenden.
|
|
|
|
## no-emoji
|
|
|
|
Verhindere die Umwandlung in Emojis:
|
|
|
|
```js
|
|
window.$docsify = {
|
|
noEmoji: true
|
|
}
|
|
```
|
|
|
|
## merge-navbar
|
|
|
|
Navbar will be merged with the sidebar on smaller screens.
|
|
|
|
```js
|
|
window.$docsify = {
|
|
mergeNavbar: true
|
|
}
|
|
```
|
|
|
|
## format-updated
|
|
We can display the file update date through **{docsify-updated<span>}</span>** variable. And format it by `formatUpdated`.
|
|
See https://github.com/lukeed/tinydate#patterns
|
|
```js
|
|
window.$docsify = {
|
|
formatUpdated: '{MM}/{DD} {HH}:{mm}',
|
|
|
|
formatUpdated: function (time) {
|
|
// ...
|
|
|
|
return time
|
|
}
|
|
}
|
|
```
|
|
|
|
## external-link-target
|
|
|
|
Currently it defaults to _blank, would be nice if configurable:
|
|
|
|
```js
|
|
window.$docsify = {
|
|
externalLinkTarget: '_self' // default: '_blank'
|
|
}
|
|
```
|
|
|
|
|
|
## noCompileLinks
|
|
|
|
- type: `Array`
|
|
|
|
|
|
Sometimes we do not want docsify to handle our links. See [#203](https://github.com/QingWei-Li/docsify/issues/203)
|
|
|
|
|
|
```js
|
|
window.$docsify = {
|
|
noCompileLinks: [
|
|
'/foo',
|
|
'/bar/.*'
|
|
]
|
|
}
|
|
```
|