diff --git a/.eslintignore b/.eslintignore deleted file mode 100644 index a3b8548..0000000 --- a/.eslintignore +++ /dev/null @@ -1,5 +0,0 @@ -.git -packages/docsify-server-renderer/build.js -node_modules -build -server.js \ No newline at end of file diff --git a/.eslintrc b/.eslintrc index a8f7cd0..527ed9b 100644 --- a/.eslintrc +++ b/.eslintrc @@ -1,20 +1,9 @@ { - "extends": "xo-space/browser", - "rules": { - "semi": [2, "never"], - "no-return-assign": "off", - "no-unused-expressions": "off", - "no-new-func": "off", - "no-multi-assign": "off", - "no-mixed-operators": "off", - "max-params": "off", - "no-script-url": "off", - "camelcase": "off", - "no-warning-comments": "off" + "extends": ["vue"], + "env": { + "browser": true }, "globals": { - "Docsify": true, - "$docsify": true, - "process": true + "$docsify": true } } diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md deleted file mode 100644 index 35d6b90..0000000 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -name: Bug report -about: Create a report to help us improve - ---- - - - - - -## Bug Report - -#### Steps to reproduce - - - -#### What is current behaviour - - - -#### What is the expected behaviour - - - -#### Other relevant information - - -- [ ] Bug does still occur when all/other plugins are disabled? - -- Your OS: -- Node.js version: -- npm/yarn version: -- Browser version: -- Docsify version: -- Docsify plugins: - - diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md deleted file mode 100644 index 501e4de..0000000 --- a/.github/ISSUE_TEMPLATE/feature_request.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -name: Feature request -about: Suggest an idea for this project - ---- - - - - - -## Feature request - -#### What problem does this feature solve? - - - -#### What does the proposed API look like? - - - -#### How should this be implemented in your opinion? - - - -#### Are you willing to work on this yourself? diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md deleted file mode 100644 index bb31bd4..0000000 --- a/.github/PULL_REQUEST_TEMPLATE.md +++ /dev/null @@ -1,54 +0,0 @@ - - - - - - -**Summary** - -**What kind of change does this PR introduce?** (check at least one) - -- [ ] Bugfix -- [ ] Feature -- [ ] Code style update -- [ ] Refactor -- [ ] Docs -- [ ] Build-related changes -- [ ] Other, please describe: - -If changing the UI of default theme, please provide the **before/after** screenshot: - -**Does this PR introduce a breaking change?** (check one) - -- [ ] Yes -- [ ] No - -If yes, please describe the impact and migration path for existing applications: - -**The PR fulfills these requirements:** - -- [ ] When resolving a specific issue, it's referenced in the PR's title (e.g. `fix #xxx[,#xxx]`, where "xxx" is the issue number) - -You have tested in the following browsers: (Providing a detailed version will be better.) - -- [ ] Chrome -- [ ] Firefox -- [ ] Safari -- [ ] Edge -- [ ] IE - -If adding a **new feature**, the PR's description includes: - -- [ ] A convincing reason for adding this feature -- [ ] Related documents have been updated -- [ ] Related tests have been updated - -To avoid wasting your time, it's best to open a **feature request issue** first and wait for approval before working on it. - - -**Other information:** - ---- - -* [ ] DO NOT include files inside `lib` directory. - diff --git a/.gitignore b/.gitignore index ea4b5b8..ee8a519 100644 --- a/.gitignore +++ b/.gitignore @@ -1,9 +1,4 @@ -*.log .DS_Store -.idea +*.log node_modules -themes/ -lib/ - -# exceptions -!.gitkeep \ No newline at end of file +/themes \ No newline at end of file diff --git a/.npmignore b/.npmignore deleted file mode 100644 index 41b1431..0000000 --- a/.npmignore +++ /dev/null @@ -1,5 +0,0 @@ -.eslintignore -.eslintrc -.github/ -.gitignore -.travis.yml diff --git a/.travis.yml b/.travis.yml index 87576c5..fb0b83e 100644 --- a/.travis.yml +++ b/.travis.yml @@ -1,3 +1,6 @@ sudo: false +cache: + directories: + - $HOME/.yarn-cache language: node_js node_js: stable diff --git a/.vscode/settings.json b/.vscode/settings.json deleted file mode 100644 index b7d6eb8..0000000 --- a/.vscode/settings.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "prettier.eslintIntegration": true -} diff --git a/CHANGELOG.md b/CHANGELOG.md index 267d402..0365bbf 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,753 +1,66 @@ - -## [4.9.4](https://github.com/docsifyjs/docsify/compare/v4.9.2...v4.9.4) (2019-05-05) +### 2.3.0 +> 2017-02-13 +#### Features - -## [4.9.2](https://github.com/docsifyjs/docsify/compare/v4.9.1...v4.9.2) (2019-04-21) +- feat(src): add alias feature +- docs: update all documents +- feat(src): dynamic title +- feat(hook): support custom plugin +- feat(themes): add dark theme +#### Bug fixes +- fix(event): `auto2top` has no effect on a FF mobile browser, fixed #67 +- fix: sidebar style +- fix(render): fix render link -### Bug Fixes +### 2.2.1 -* re-render gitalk when router changed ([11ea1f8](https://github.com/docsifyjs/docsify/commit/11ea1f8)) +> 2017-02-11 +#### Bug fixes +- fix(search): crash when not content, fixed #68 +- fix(event): scroll active sidebar +- fix(search): not work in mobile -### Features +### 2.2.0 -* allows relative path, fixed [#590](https://github.com/docsifyjs/docsify/issues/590) ([31654f1](https://github.com/docsifyjs/docsify/commit/31654f1)) +#### Features +- Add `Google Analytics` plugin. +```html + + +``` +### 2.1.0 +#### Features +- Add search plugin +```html + + +``` +#### Bug fixes +- fix sidebar style - -## [4.9.1](https://github.com/docsifyjs/docsify/compare/v4.9.0...v4.9.1) (2019-02-21) +### 2.0.3 +#### Bug fixes +- fix: rendering emojis +- fix: css var polyfill +### 2.0.2 -### Bug Fixes +#### Bug fixes +- fix button style in cover page. -* github assets url ([#774](https://github.com/docsifyjs/docsify/issues/774)) ([140bf10](https://github.com/docsifyjs/docsify/commit/140bf10)) +### 2.0.1 +#### Bug fixes +- border style. +### 2.0.0 +#### Features +- Customize the theme color - - -# [4.9.0](https://github.com/docsifyjs/docsify/compare/v4.8.6...v4.9.0) (2019-02-19) - - -### Bug Fixes - -* task list rendering (Fix [#749](https://github.com/docsifyjs/docsify/issues/749)) ([#757](https://github.com/docsifyjs/docsify/issues/757)) ([69ef489](https://github.com/docsifyjs/docsify/commit/69ef489)) -* upgrade npm-run-all ([049726e](https://github.com/docsifyjs/docsify/commit/049726e)) - - -### Features - -* **search-plugin:** add namespace option ([#706](https://github.com/docsifyjs/docsify/issues/706)) ([28beff8](https://github.com/docsifyjs/docsify/commit/28beff8)) -* Add new theme "dolphin" ([#735](https://github.com/docsifyjs/docsify/issues/735)) ([c3345ba](https://github.com/docsifyjs/docsify/commit/c3345ba)) -* Provide code fragments feature ([#748](https://github.com/docsifyjs/docsify/issues/748)) ([1447c8a](https://github.com/docsifyjs/docsify/commit/1447c8a)) - - - - -## [4.8.6](https://github.com/docsifyjs/docsify/compare/v4.8.5...v4.8.6) (2018-11-12) - - -### Bug Fixes - -* IE10 compatibility ([#691](https://github.com/docsifyjs/docsify/issues/691)) ([4db8cd6](https://github.com/docsifyjs/docsify/commit/4db8cd6)) - - - - -## [4.8.5](https://github.com/docsifyjs/docsify/compare/v4.8.4...v4.8.5) (2018-11-02) - - -### Bug Fixes - -* expose version info for Docsify, fixed [#641](https://github.com/docsifyjs/docsify/issues/641) ([aa719e3](https://github.com/docsifyjs/docsify/commit/aa719e3)) - - - - -## [4.8.4](https://github.com/docsifyjs/docsify/compare/v4.8.3...v4.8.4) (2018-11-01) - - -### Bug Fixes - -* **cover:** Compatible with legacy styles, fixed [#677](https://github.com/docsifyjs/docsify/issues/677) ([#678](https://github.com/docsifyjs/docsify/issues/678)) ([1a945d4](https://github.com/docsifyjs/docsify/commit/1a945d4)) - - - - - -## [4.8.3](https://github.com/docsifyjs/docsify/compare/v4.8.2...v4.8.3) (2018-11-01) - -Fix the last release files has the old version marked... - - - -## [4.8.2](https://github.com/docsifyjs/docsify/compare/v4.8.1...v4.8.2) (2018-11-01) - -### Bug Fixes - -- cover button style, fixed [#670](https://github.com/docsifyjs/docsify/issues/670), fixed [#665](https://github.com/docsifyjs/docsify/issues/665) ([#675](https://github.com/docsifyjs/docsify/issues/675)) ([fcd1087](https://github.com/docsifyjs/docsify/commit/fcd1087)) -- update match regex ([#669](https://github.com/docsifyjs/docsify/issues/669)) ([2edf47e](https://github.com/docsifyjs/docsify/commit/2edf47e)) -- use copy of cached value ([#668](https://github.com/docsifyjs/docsify/issues/668)) ([5fcf210](https://github.com/docsifyjs/docsify/commit/5fcf210)) -- **compiler:** import prism-markup-templating, fixed [#672](https://github.com/docsifyjs/docsify/issues/672) ([#676](https://github.com/docsifyjs/docsify/issues/676)) ([fdd8826](https://github.com/docsifyjs/docsify/commit/fdd8826)) - -### Features - -- add heading config id ([#671](https://github.com/docsifyjs/docsify/issues/671)) ([ab19b13](https://github.com/docsifyjs/docsify/commit/ab19b13)) - - - -## [4.8.1](https://github.com/docsifyjs/docsify/compare/v4.8.0...v4.8.1) (2018-10-31) - -### Bug Fixes - -- ssr package dep, fixed [#605](https://github.com/docsifyjs/docsify/issues/605) ([2bc880d](https://github.com/docsifyjs/docsify/commit/2bc880d)) -- **compiler:** extra quotes for codeblock ([4f588e0](https://github.com/docsifyjs/docsify/commit/4f588e0)) -- **compiler:** prevent render of html code in paragraph, fixed [#663](https://github.com/docsifyjs/docsify/issues/663) ([d35059d](https://github.com/docsifyjs/docsify/commit/d35059d)) - -### Features - -- upgrade PrismJS, fixed [#534](https://github.com/docsifyjs/docsify/issues/534) ([4805cb5](https://github.com/docsifyjs/docsify/commit/4805cb5)) - - - -# [4.8.0](https://github.com/docsifyjs/docsify/compare/v4.7.1...v4.8.0) (2018-10-31) - -### Bug Fixes - -- Cache TOC for later usage in the case of cached file html ([#649](https://github.com/docsifyjs/docsify/issues/649)) ([9e86017](https://github.com/docsifyjs/docsify/commit/9e86017)) -- improve external script plugin ([#632](https://github.com/docsifyjs/docsify/issues/632)) ([50c2434](https://github.com/docsifyjs/docsify/commit/50c2434)) -- missing variable declaration ([#660](https://github.com/docsifyjs/docsify/issues/660)) ([1ce37bd](https://github.com/docsifyjs/docsify/commit/1ce37bd)) -- Remove target for mailto links ([#652](https://github.com/docsifyjs/docsify/issues/652)) ([18f0f03](https://github.com/docsifyjs/docsify/commit/18f0f03)) -- Update getAllPath query selector ([#653](https://github.com/docsifyjs/docsify/issues/653)) ([f6f4e32](https://github.com/docsifyjs/docsify/commit/f6f4e32)) -- Update vue.styl ([#634](https://github.com/docsifyjs/docsify/issues/634)) ([bf060be](https://github.com/docsifyjs/docsify/commit/bf060be)) - -### Features - -- Add docsify version to $window.docsify object ([#641](https://github.com/docsifyjs/docsify/issues/641)) ([94bc415](https://github.com/docsifyjs/docsify/commit/94bc415)), closes [#521](https://github.com/docsifyjs/docsify/issues/521) -- **compiler:** support embedded mermaid ([#629](https://github.com/docsifyjs/docsify/issues/629)) ([42ea8af](https://github.com/docsifyjs/docsify/commit/42ea8af)) -- Add hideOtherSidebarContent option ([#661](https://github.com/docsifyjs/docsify/issues/661)) ([4a23c4a](https://github.com/docsifyjs/docsify/commit/4a23c4a)) -- Allow base64, external, and relative logo values ([#642](https://github.com/docsifyjs/docsify/issues/642)) ([0a0802a](https://github.com/docsifyjs/docsify/commit/0a0802a)), closes [#577](https://github.com/docsifyjs/docsify/issues/577) -- upgrade marked to 0.5.x, fixed [#645](https://github.com/docsifyjs/docsify/issues/645), close [#644](https://github.com/docsifyjs/docsify/issues/644) ([#662](https://github.com/docsifyjs/docsify/issues/662)) ([a39b214](https://github.com/docsifyjs/docsify/commit/a39b214)) - - - -## [4.7.1](https://github.com/docsifyjs/docsify/compare/v4.7.0...v4.7.1) (2018-08-30) - - - -# [4.7.0](https://github.com/QingWei-Li/docsify/compare/v4.6.9...v4.7.0) (2018-06-29) - -### Bug Fixes - -- alldow addition content in sidebar, fix [#518](https://github.com/QingWei-Li/docsify/issues/518), fix 539 ([#543](https://github.com/QingWei-Li/docsify/issues/543)) ([04b36b0](https://github.com/QingWei-Li/docsify/commit/04b36b0)) -- async install config, fixed [#425](https://github.com/QingWei-Li/docsify/issues/425) ([e4e011c](https://github.com/QingWei-Li/docsify/commit/e4e011c)) -- loading embed files synchronously, fixed [#525](https://github.com/QingWei-Li/docsify/issues/525), fixed [#527](https://github.com/QingWei-Li/docsify/issues/527) ([#544](https://github.com/QingWei-Li/docsify/issues/544)) ([feea7f9](https://github.com/QingWei-Li/docsify/commit/feea7f9)) -- path include chinese character cause hilight bug ([#556](https://github.com/QingWei-Li/docsify/issues/556)) ([a5f333a](https://github.com/QingWei-Li/docsify/commit/a5f333a)) - -### Features - -- add logo option, [#264](https://github.com/QingWei-Li/docsify/issues/264) ([#541](https://github.com/QingWei-Li/docsify/issues/541)) ([ee72dd0](https://github.com/QingWei-Li/docsify/commit/ee72dd0)) -- add unpkg field, close [#531](https://github.com/QingWei-Li/docsify/issues/531) ([#558](https://github.com/QingWei-Li/docsify/issues/558)) ([5c0de0a](https://github.com/QingWei-Li/docsify/commit/5c0de0a)) -- support image resizing, resolve [#508](https://github.com/QingWei-Li/docsify/issues/508) ([#545](https://github.com/QingWei-Li/docsify/issues/545)) ([3a7ad62](https://github.com/QingWei-Li/docsify/commit/3a7ad62)) - - - -## [4.6.10](https://github.com/QingWei-Li/docsify/compare/v4.6.9...v4.6.10) (2018-03-25) - -### Bug Fixes - -- async install config, fixed [#425](https://github.com/QingWei-Li/docsify/issues/425) ([e4e011c](https://github.com/QingWei-Li/docsify/commit/e4e011c)) - - - -## [4.6.9](https://github.com/QingWei-Li/docsify/compare/v4.6.8...v4.6.9) (2018-03-10) - -### Bug Fixes - -- upgrade medium-zoom, fixed [#417](https://github.com/QingWei-Li/docsify/issues/417) ([6a3d69a](https://github.com/QingWei-Li/docsify/commit/6a3d69a)) - - - -## [4.6.8](https://github.com/QingWei-Li/docsify/compare/v4.6.7...v4.6.8) (2018-03-06) - -### Bug Fixes - -- resolve path of image and embed files, fixed [#412](https://github.com/QingWei-Li/docsify/issues/412) ([bfd0d18](https://github.com/QingWei-Li/docsify/commit/bfd0d18)) - - - -## [4.6.7](https://github.com/QingWei-Li/docsify/compare/v4.6.6...v4.6.7) (2018-03-03) - -### Bug Fixes - -- layout css, fixed [#409](https://github.com/QingWei-Li/docsify/issues/409) ([aeb692e](https://github.com/QingWei-Li/docsify/commit/aeb692e)) - - - -## [4.6.6](https://github.com/QingWei-Li/docsify/compare/v4.6.5...v4.6.6) (2018-03-03) - - - -## [4.6.5](https://github.com/QingWei-Li/docsify/compare/v4.6.4...v4.6.5) (2018-03-03) - -### Bug Fixes - -- **navbar:** Now Navbar isn't append to DOM when loadNavbar is falsy ([#407](https://github.com/QingWei-Li/docsify/issues/407)) ([0933445](https://github.com/QingWei-Li/docsify/commit/0933445)) - -### Features - -- **config:** Add 404 page options. ([#406](https://github.com/QingWei-Li/docsify/issues/406)) ([9b3b445](https://github.com/QingWei-Li/docsify/commit/9b3b445)) - - - -## [4.6.4](https://github.com/QingWei-Li/docsify/compare/v4.6.3...v4.6.4) (2018-03-01) - -### Bug Fixes - -- **render:** Disable markdown parsing when the file is an HTML ([#403](https://github.com/QingWei-Li/docsify/issues/403)) ([278a75e](https://github.com/QingWei-Li/docsify/commit/278a75e)) - -### Features - -- **fetch:** Add fallback languages configuration. ([#402](https://github.com/QingWei-Li/docsify/issues/402)) ([ecc0e04](https://github.com/QingWei-Li/docsify/commit/ecc0e04)) - - - -## [4.6.3](https://github.com/QingWei-Li/docsify/compare/v4.6.2...v4.6.3) (2018-02-15) - -### Bug Fixes - -- **hook:** beforeEach don\'t work, fixed [#393](https://github.com/QingWei-Li/docsify/issues/393) ([6a09059](https://github.com/QingWei-Li/docsify/commit/6a09059)) - - - -## [4.6.2](https://github.com/QingWei-Li/docsify/compare/v4.6.1...v4.6.2) (2018-02-14) - -### Bug Fixes - -- **embed:** broken in IE, fixed [#389](https://github.com/QingWei-Li/docsify/issues/389), fixed [#391](https://github.com/QingWei-Li/docsify/issues/391) ([45a7464](https://github.com/QingWei-Li/docsify/commit/45a7464)) -- **embed:** init value ([890a7bf](https://github.com/QingWei-Li/docsify/commit/890a7bf)) - - - -## [4.6.1](https://github.com/QingWei-Li/docsify/compare/v4.6.0...v4.6.1) (2018-02-12) - -### Bug Fixes - -- **embed** compatible ssr ([dc0c3ce](https://github.com/QingWei-Li/docsify/commit/dc0c3ce)) -- **embed** async fetch embed files, fixed [#387](https://github.com/QingWei-Li/docsify/issues/387) - - - -# [4.6.0](https://github.com/QingWei-Li/docsify/compare/v4.5.9...v4.6.0) (2018-02-11) - -### Bug Fixes - -- **search:** custom clear button, fixed [#271](https://github.com/QingWei-Li/docsify/issues/271) ([864aa18](https://github.com/QingWei-Li/docsify/commit/864aa18)) -- **search:** escape special characters for search, fixed [#369](https://github.com/QingWei-Li/docsify/issues/369) ([9755439](https://github.com/QingWei-Li/docsify/commit/9755439)) -- build config ([342438f](https://github.com/QingWei-Li/docsify/commit/342438f)) -- button style for coverpage, fixed [#362](https://github.com/QingWei-Li/docsify/issues/362) ([85428ef](https://github.com/QingWei-Li/docsify/commit/85428ef)) -- dropdown scroll style, fixed [#346](https://github.com/QingWei-Li/docsify/issues/346) ([c4d83f2](https://github.com/QingWei-Li/docsify/commit/c4d83f2)) -- highlight homepage link, fixed [#304](https://github.com/QingWei-Li/docsify/issues/304) ([f960c19](https://github.com/QingWei-Li/docsify/commit/f960c19)) -- homepage link ([e097f88](https://github.com/QingWei-Li/docsify/commit/e097f88)) -- onlyCover ([033be4f](https://github.com/QingWei-Li/docsify/commit/033be4f)) -- ssr compatible embedd ([ebc10c4](https://github.com/QingWei-Li/docsify/commit/ebc10c4)) -- ssr coverpage, fixed [#273](https://github.com/QingWei-Li/docsify/issues/273) ([9e824a4](https://github.com/QingWei-Li/docsify/commit/9e824a4)) - -### Features - -- click sidebar menu add collapse and expand, close [#294](https://github.com/QingWei-Li/docsify/issues/294) ([5e161a1](https://github.com/QingWei-Li/docsify/commit/5e161a1)) -- **compiler:** support embedded file as code block, close [#134](https://github.com/QingWei-Li/docsify/issues/134) ([761ccc2](https://github.com/QingWei-Li/docsify/commit/761ccc2)) -- **compiler:** support embedded markdown, html, video, etc files, close [#383](https://github.com/QingWei-Li/docsify/issues/383), close [#333](https://github.com/QingWei-Li/docsify/issues/333) ([524f52f](https://github.com/QingWei-Li/docsify/commit/524f52f)) -- **cover:** add onlyCover option, close [#382](https://github.com/QingWei-Li/docsify/issues/382) ([b265fdd](https://github.com/QingWei-Li/docsify/commit/b265fdd)) -- **fetch:** add requestHeaders option, fixed [#336](https://github.com/QingWei-Li/docsify/issues/336) ([54ab4c9](https://github.com/QingWei-Li/docsify/commit/54ab4c9)) -- **render:** add ext option for custom file extenstion, close [#340](https://github.com/QingWei-Li/docsify/issues/340) ([248aa72](https://github.com/QingWei-Li/docsify/commit/248aa72)) -- **render:** mutilple coverpage, close [#315](https://github.com/QingWei-Li/docsify/issues/315) ([f68ddf5](https://github.com/QingWei-Li/docsify/commit/f68ddf5)) - - - -## [4.5.9](https://github.com/QingWei-Li/docsify/compare/v4.5.8...v4.5.9) (2018-02-07) - -### Bug Fixes - -- upgrade marked ([4157173](https://github.com/QingWei-Li/docsify/commit/4157173)) - - - -## [4.5.8](https://github.com/QingWei-Li/docsify/compare/v4.5.6...v4.5.8) (2018-02-07) - -### Bug Fixes - -- cover style, fixed [#381](https://github.com/QingWei-Li/docsify/issues/381) ([368754e](https://github.com/QingWei-Li/docsify/commit/368754e)) -- updated deps ([#337](https://github.com/QingWei-Li/docsify/issues/337)) ([a12d393](https://github.com/QingWei-Li/docsify/commit/a12d393)) - - - -## [4.5.7](https://github.com/QingWei-Li/docsify/compare/v4.5.6...v4.5.7) (2017-12-29) - -### Features - -- add navigation plugin, closed [#180](https://github.com/QingWei-Li/docsify/issues/180) ([f78be4c](https://github.com/QingWei-Li/docsify/commit/f78be4c)) - - - -## [4.5.6](https://github.com/QingWei-Li/docsify/compare/v4.5.3...v4.5.6) (2017-12-14) - -### Bug Fixes - -- **style:** increase the tap targets of menu button, fixed [#325](https://github.com/QingWei-Li/docsify/issues/325) ([888f217](https://github.com/QingWei-Li/docsify/commit/888f217)) - - - -## [4.5.5](https://github.com/QingWei-Li/docsify/compare/v4.5.4...v4.5.5) (2017-11-30) - -### Bug Fixes - -- disqus plugin issue ([#318](https://github.com/QingWei-Li/docsify/issues/318)) ([041b33e](https://github.com/QingWei-Li/docsify/commit/041b33e)), closes [#317](https://github.com/QingWei-Li/docsify/issues/317) - - - -## [4.5.4](https://github.com/QingWei-Li/docsify/compare/v4.5.2...v4.5.4) (2017-11-29) - -### Bug Fixes - -- **compiler:** task lists style, fixed [#215](https://github.com/QingWei-Li/docsify/issues/215) ([e43ded4](https://github.com/QingWei-Li/docsify/commit/e43ded4)) - -### Features - -- add gitalk plugin ([#306](https://github.com/QingWei-Li/docsify/issues/306)) ([9208e64](https://github.com/QingWei-Li/docsify/commit/9208e64)) - - - -## [4.5.3](https://github.com/QingWei-Li/docsify/compare/v4.5.2...v4.5.3) (2017-11-11) - -### Features - -- add gitalk plugin ([#306](https://github.com/QingWei-Li/docsify/issues/306)) ([9208e64](https://github.com/QingWei-Li/docsify/commit/9208e64)) - - - -## [4.5.2](https://github.com/QingWei-Li/docsify/compare/v4.5.1...v4.5.2) (2017-11-09) - -### Features - -- github task lists, close [#215](https://github.com/QingWei-Li/docsify/issues/215) ([#305](https://github.com/QingWei-Li/docsify/issues/305)) ([d486eef](https://github.com/QingWei-Li/docsify/commit/d486eef)) - - - -## [4.5.1](https://github.com/QingWei-Li/docsify/compare/v4.5.0...v4.5.1) (2017-11-07) - -### Features - -- fetch files with the query params, fixed [#303](https://github.com/QingWei-Li/docsify/issues/303) ([2a2ed96](https://github.com/QingWei-Li/docsify/commit/2a2ed96)) - - - -# [4.5.0](https://github.com/QingWei-Li/docsify/compare/v4.4.1...v4.5.0) (2017-11-04) - -### Features - -- add disqus plugin, closed [#123](https://github.com/QingWei-Li/docsify/issues/123) ([fd7d4e0](https://github.com/QingWei-Li/docsify/commit/fd7d4e0)) - - - -## [4.4.1](https://github.com/QingWei-Li/docsify/compare/v4.4.0...v4.4.1) (2017-10-31) - -### Bug Fixes - -- {docsify-ignore-all} and {docsify-ignore} bug ([#299](https://github.com/QingWei-Li/docsify/issues/299)) ([cc98f56](https://github.com/QingWei-Li/docsify/commit/cc98f56)) -- zoom image plugin issue, fixed [#187](https://github.com/QingWei-Li/docsify/issues/187) ([#300](https://github.com/QingWei-Li/docsify/issues/300)) ([fa772cf](https://github.com/QingWei-Li/docsify/commit/fa772cf)) - - - -# [4.4.0](https://github.com/QingWei-Li/docsify/compare/v4.3.15...v4.4.0) (2017-10-30) - -### Bug Fixes - -- sidebar style issue on firefox, fixed [#184](https://github.com/QingWei-Li/docsify/issues/184) ([#297](https://github.com/QingWei-Li/docsify/issues/297)) ([36bfc9d](https://github.com/QingWei-Li/docsify/commit/36bfc9d)) - -### Features - -- add helper for disabled link, fixed [#295](https://github.com/QingWei-Li/docsify/issues/295) ([#296](https://github.com/QingWei-Li/docsify/issues/296)) ([4ad96f3](https://github.com/QingWei-Li/docsify/commit/4ad96f3)) - - - -## [4.3.15](https://github.com/QingWei-Li/docsify/compare/v4.3.14...v4.3.15) (2017-10-20) - -### Bug Fixes - -- scroll active sidebar ([a2b8eae](https://github.com/QingWei-Li/docsify/commit/a2b8eae)) - - - -## [4.3.14](https://github.com/QingWei-Li/docsify/compare/v4.3.13...v4.3.14) (2017-10-20) - -### Bug Fixes - -- codesponsor style ([ab68268](https://github.com/QingWei-Li/docsify/commit/ab68268)) - - - -## [4.3.13](https://github.com/QingWei-Li/docsify/compare/v4.3.12...v4.3.13) (2017-10-17) - -### Bug Fixes - -- duplicate results in search fixed [#257](https://github.com/QingWei-Li/docsify/issues/257) ([#284](https://github.com/QingWei-Li/docsify/issues/284)) ([3476f6f](https://github.com/QingWei-Li/docsify/commit/3476f6f)) - -### Features - -- make whole search result clickable ([#285](https://github.com/QingWei-Li/docsify/issues/285)) ([1b91227](https://github.com/QingWei-Li/docsify/commit/1b91227)) - - - -## [4.3.12](https://github.com/QingWei-Li/docsify/compare/v4.3.11...v4.3.12) (2017-10-15) - -### Bug Fixes - -- incorrect active link ([#281](https://github.com/QingWei-Li/docsify/issues/281)) ([a3ab379](https://github.com/QingWei-Li/docsify/commit/a3ab379)) - - - -## [4.3.11](https://github.com/QingWei-Li/docsify/compare/v4.3.10...v4.3.11) (2017-10-15) - -### Bug Fixes - -- broken links to same page heading, fix [#278](https://github.com/QingWei-Li/docsify/issues/278), fix [#279](https://github.com/QingWei-Li/docsify/issues/279) ([91d6337](https://github.com/QingWei-Li/docsify/commit/91d6337)) - - - -## [4.3.10](https://github.com/QingWei-Li/docsify/compare/v4.3.9...v4.3.10) (2017-10-12) - -### Bug Fixes - -- link render issue after page refreshing ([#276](https://github.com/QingWei-Li/docsify/issues/276)) ([abd885e](https://github.com/QingWei-Li/docsify/commit/abd885e)) - - - -## [4.3.9](https://github.com/QingWei-Li/docsify/compare/v4.3.8...v4.3.9) (2017-10-11) - -### Bug Fixes - -- scroll issue in IE ([#275](https://github.com/QingWei-Li/docsify/issues/275)) ([3e94cb6](https://github.com/QingWei-Li/docsify/commit/3e94cb6)) - - - -## [4.3.8](https://github.com/QingWei-Li/docsify/compare/v4.3.7...v4.3.8) (2017-10-07) - -### Bug Fixes - -- **slugify:** GitHub compatible heading links, fixed [#272](https://github.com/QingWei-Li/docsify/issues/272) ([9b4e666](https://github.com/QingWei-Li/docsify/commit/9b4e666)) - - - -## [4.3.7](https://github.com/QingWei-Li/docsify/compare/v4.3.6...v4.3.7) (2017-10-02) - -### Bug Fixes - -- **slugify:** GitHub compatible heading links, fixed [#267](https://github.com/QingWei-Li/docsify/issues/267) ([c195d2d](https://github.com/QingWei-Li/docsify/commit/c195d2d)) - - - -## [4.3.6](https://github.com/QingWei-Li/docsify/compare/v4.3.5...v4.3.6) (2017-09-21) - -### Bug Fixes - -- style for codesponsor plugin ([08afec7](https://github.com/QingWei-Li/docsify/commit/08afec7)) - - - -## [4.3.5](https://github.com/QingWei-Li/docsify/compare/v4.3.4...v4.3.5) (2017-09-20) - -### Bug Fixes - -- missed symbol ([#254](https://github.com/QingWei-Li/docsify/issues/254)) ([6c702d3](https://github.com/QingWei-Li/docsify/commit/6c702d3)) - -### Features - -- **plugin:** add codesponsor plugin ([46ac4c3](https://github.com/QingWei-Li/docsify/commit/46ac4c3)) - - - -## [4.3.4](https://github.com/QingWei-Li/docsify/compare/v4.3.3...v4.3.4) (2017-09-07) - -### Bug Fixes - -- scroll position issue, fixed [#234](https://github.com/QingWei-Li/docsify/issues/234) ([388ed3d](https://github.com/QingWei-Li/docsify/commit/388ed3d)) - - - -## [4.3.3](https://github.com/QingWei-Li/docsify/compare/v4.3.2...v4.3.3) (2017-09-06) - -### Bug Fixes - -- **buble.css:** tweaks code block style, fixed [#249](https://github.com/QingWei-Li/docsify/issues/249) ([9d43051](https://github.com/QingWei-Li/docsify/commit/9d43051)) - -### Features - -- add doc for react and vue demo box plugin ([#247](https://github.com/QingWei-Li/docsify/issues/247)) ([f0aca19](https://github.com/QingWei-Li/docsify/commit/f0aca19)) - - - -## [4.3.2](https://github.com/QingWei-Li/docsify/compare/v4.3.1...v4.3.2) (2017-09-01) - -### Bug Fixes - -- sidebar highlight ([f82f419](https://github.com/QingWei-Li/docsify/commit/f82f419)) - -### Features - -- add Edit on github plugin (thanks [@njleonzhang](https://github.com/njleonzhang)) ([a0e1ea8](https://github.com/QingWei-Li/docsify/commit/a0e1ea8)) - - - -## [4.3.1](https://github.com/QingWei-Li/docsify/compare/v4.2.9...v4.3.1) (2017-08-30) - -### Features - -- **markdown:** supports mermaid [#137](https://github.com/QingWei-Li/docsify/issues/137) ([f4800e0](https://github.com/QingWei-Li/docsify/commit/f4800e0)) - - - -# [4.3.0](https://github.com/QingWei-Li/docsify/compare/v4.2.9...v4.3.0) (2017-08-17) - -### Features - -- **markdown:** supports mermaid [#137](https://github.com/QingWei-Li/docsify/issues/137) ([f4800e0](https://github.com/QingWei-Li/docsify/commit/f4800e0)) - - - -## [4.2.9](https://github.com/QingWei-Li/docsify/compare/v4.2.8...v4.2.9) (2017-08-15) - -### Bug Fixes - -- ensure document ready before init Docsify [#233](https://github.com/QingWei-Li/docsify/issues/233) - - - -## [4.2.8](https://github.com/QingWei-Li/docsify/compare/v4.2.7...v4.2.8) (2017-08-10) - -### Features - -- **compiler:** support for setting target attribute for link, fixed [#230](https://github.com/QingWei-Li/docsify/issues/230) ([7f270f9](https://github.com/QingWei-Li/docsify/commit/7f270f9)) - - - -## [4.2.7](https://github.com/QingWei-Li/docsify/compare/v4.2.4...v4.2.7) (2017-08-05) - -### Bug Fixes - -- **release:** release shell ([628e211](https://github.com/QingWei-Li/docsify/commit/628e211)) -- **style:** nowrap => pre-wrap, fixed [#228](https://github.com/QingWei-Li/docsify/issues/228) ([a88252c](https://github.com/QingWei-Li/docsify/commit/a88252c)) - - - -## [4.2.6](https://github.com/QingWei-Li/docsify/compare/v4.2.4...v4.2.6) (2017-07-27) - -### Bug Fixes - -- **css:** hide the nav when the content has not yet been loaded ([1fa1619](https://github.com/QingWei-Li/docsify/commit/1fa1619)) -- **release:** release shell ([628e211](https://github.com/QingWei-Li/docsify/commit/628e211)) - - - -## [4.2.4](https://github.com/QingWei-Li/docsify/compare/v4.2.2...v4.2.4) (2017-07-26) - -### Bug Fixes - -- **render:** Remove getRootNode to be compatible with the lower version of Chrome, fixed [#225](https://github.com/QingWei-Li/docsify/issues/225) ([b8dd346](https://github.com/QingWei-Li/docsify/commit/b8dd346)) - - - -## [4.2.3](https://github.com/QingWei-Li/docsify/compare/v4.2.2...v4.2.3) (2017-07-26) - -### Features - -- **search:** Supports the max depth of the search headline, fixed [#223](https://github.com/QingWei-Li/docsify/issues/223), resolve [#129](https://github.com/QingWei-Li/docsify/issues/129) ([b7b589b](https://github.com/QingWei-Li/docsify/commit/b7b589b)) - - - -## [4.2.2](https://github.com/QingWei-Li/docsify/compare/v4.2.1...v4.2.2) (2017-07-24) - -### Bug Fixes - -- style rerender due to setting themeColor ([17ff3d1](https://github.com/QingWei-Li/docsify/commit/17ff3d1)) - - - -## [4.2.1](https://github.com/QingWei-Li/docsify/compare/v4.2.0...v4.2.1) (2017-07-19) - -- give the navbar some line-height (#216) -- Remove unnecessary moduleName option from rollup config for plugins (#209) - - - -# [4.2.0](https://github.com/QingWei-Li/docsify/compare/v4.1.14...v4.2.0) (2017-07-10) - -### Bug Fixes - -- not found page ([9af8559](https://github.com/QingWei-Li/docsify/commit/9af8559)) - -### Features - -- alias option supports regexp, resolve [#183](https://github.com/QingWei-Li/docsify/issues/183) ([c4aa22c](https://github.com/QingWei-Li/docsify/commit/c4aa22c)) -- ignore to compiled link, fixed [#203](https://github.com/QingWei-Li/docsify/issues/203) ([#204](https://github.com/QingWei-Li/docsify/issues/204)) ([2e00f4c](https://github.com/QingWei-Li/docsify/commit/2e00f4c)) - - - -## [4.1.14](https://github.com/QingWei-Li/docsify/compare/v4.1.13...v4.1.14) (2017-06-24) - -### Bug Fixes - -- get file path, fixed jrappen/sublime-distractionless/commit/81bfadd391428823191cc03eca956a2312e04d13#commitcomment-22427070 ([e8117e5](https://github.com/QingWei-Li/docsify/commit/e8117e5)), closes [jrappen/sublime-distractionless/commit/81bfadd391428823191cc03eca956a2312e04d13#commitcomment-22427070](https://github.com/jrappen/sublime-distractionless/commit/81bfadd391428823191cc03eca956a2312e04d13/issues/commitcomment-22427070) - -### Features - -- add context attribute, fixed [#191](https://github.com/QingWei-Li/docsify/issues/191) ([ce0e9ac](https://github.com/QingWei-Li/docsify/commit/ce0e9ac)) - - - -## [4.1.13](https://github.com/QingWei-Li/docsify/compare/v4.1.12...v4.1.13) (2017-06-11) - - - -## [4.1.12](https://github.com/QingWei-Li/docsify/compare/v4.1.11...v4.1.12) (2017-06-03) - -### Bug Fixes - -- **render:** subtitle in side bar shows undefined, fixed [#182](https://github.com/QingWei-Li/docsify/issues/182) ([d087d57](https://github.com/QingWei-Li/docsify/commit/d087d57)) - - - -## [4.1.11](https://github.com/QingWei-Li/docsify/compare/v4.1.10...v4.1.11) (2017-06-02) - -### Bug Fixes - -- **compiler:** force reset toc when rendering sidebar fixed [#181](https://github.com/QingWei-Li/docsify/issues/181) ([ccf4c7c](https://github.com/QingWei-Li/docsify/commit/ccf4c7c)) -- **render:** autoHeader does not work ([1304d2e](https://github.com/QingWei-Li/docsify/commit/1304d2e)) - - - -## [4.1.10](https://github.com/QingWei-Li/docsify/compare/v4.1.9...v4.1.10) (2017-06-02) - -### Bug Fixes - -- **hash:** hash routing crashes when url has querystring ([6d48ce1](https://github.com/QingWei-Li/docsify/commit/6d48ce1)) - - - -## [4.1.9](https://github.com/QingWei-Li/docsify/compare/v4.1.8...v4.1.9) (2017-05-31) - -### Bug Fixes - -- can't render toc on first load ([d9b487e](https://github.com/QingWei-Li/docsify/commit/d9b487e)) -- **lifecycle:** continue to handle data ([955d3d5](https://github.com/QingWei-Li/docsify/commit/955d3d5)) -- **render:** broken name link, fixed [#167](https://github.com/QingWei-Li/docsify/issues/167) ([91b66a5](https://github.com/QingWei-Li/docsify/commit/91b66a5)) - - - -## [4.1.8](https://github.com/QingWei-Li/docsify/compare/v4.1.7...v4.1.8) (2017-05-31) - -### Bug Fixes - -- auto replace version ([22b50f0](https://github.com/QingWei-Li/docsify/commit/22b50f0)) -- update edit button demo ([ec887c1](https://github.com/QingWei-Li/docsify/commit/ec887c1)) - -### Features - -- add edit button demo ([a64cee1](https://github.com/QingWei-Li/docsify/commit/a64cee1)) -- add edit button demo, close [#162](https://github.com/QingWei-Li/docsify/issues/162) ([036fdac](https://github.com/QingWei-Li/docsify/commit/036fdac)) - - - -## [4.1.7](https://github.com/QingWei-Li/docsify/compare/v4.1.6...v4.1.7) (2017-05-30) - -### Bug Fixes - -- **ssr:** clean files ([0014895](https://github.com/QingWei-Li/docsify/commit/0014895)) - - - -## [4.1.6](https://github.com/QingWei-Li/docsify/compare/v4.1.5...v4.1.6) (2017-05-30) - -### Bug Fixes - -- **ssr:** add debug ([6b9e092](https://github.com/QingWei-Li/docsify/commit/6b9e092)) - - - -## [4.1.5](https://github.com/QingWei-Li/docsify/compare/v4.1.4...v4.1.5) (2017-05-30) - -### Bug Fixes - -- **ssr:** missing package ([6db8c9e](https://github.com/QingWei-Li/docsify/commit/6db8c9e)) - - - -## [4.1.4](https://github.com/QingWei-Li/docsify/compare/v4.1.3...v4.1.4) (2017-05-30) - -### Bug Fixes - -- **ssr:** file path ([79a83bc](https://github.com/QingWei-Li/docsify/commit/79a83bc)) - - - -## [4.1.3](https://github.com/QingWei-Li/docsify/compare/v4.1.2...v4.1.3) (2017-05-30) - -### Bug Fixes - -- update babel config ([9825db4](https://github.com/QingWei-Li/docsify/commit/9825db4)) - - - -## [4.1.2](https://github.com/QingWei-Li/docsify/compare/v4.1.1...v4.1.2) (2017-05-30) - -### Bug Fixes - -- update babel config ([80dba19](https://github.com/QingWei-Li/docsify/commit/80dba19)) - - - -## [4.1.1](https://github.com/QingWei-Li/docsify/compare/v4.1.0...v4.1.1) (2017-05-30) - -### Bug Fixes - -- build for ssr package ([4cb20a5](https://github.com/QingWei-Li/docsify/commit/4cb20a5)) -- remove history mode ([0e74e6c](https://github.com/QingWei-Li/docsify/commit/0e74e6c)) - - - -# [4.1.0](https://github.com/QingWei-Li/docsify/compare/v4.0.2...v4.1.0) (2017-05-30) - - - -## [4.0.2](https://github.com/QingWei-Li/docsify/compare/v4.0.1...v4.0.2) (2017-05-30) - -### Bug Fixes - -- basePath for history mode ([fc1cd3f](https://github.com/QingWei-Li/docsify/commit/fc1cd3f)) - - - -## [4.0.1](https://github.com/QingWei-Li/docsify/compare/v4.0.0...v4.0.1) (2017-05-29) - -### Bug Fixes - -- **ssr:** remove context ([4626157](https://github.com/QingWei-Li/docsify/commit/4626157)) -- lint ([b764b6e](https://github.com/QingWei-Li/docsify/commit/b764b6e)) - - - -# [4.0.0](https://github.com/QingWei-Li/docsify/compare/v3.7.3...v4.0.0) (2017-05-29) - -### Bug Fixes - -- **render:** init event in ssr ([eba1c98](https://github.com/QingWei-Li/docsify/commit/eba1c98)) -- lint ([1f4514d](https://github.com/QingWei-Li/docsify/commit/1f4514d)) - -### Features - -- finish ssr ([3444884](https://github.com/QingWei-Li/docsify/commit/3444884)) -- init ocsify-server-renderer ([6dea685](https://github.com/QingWei-Li/docsify/commit/6dea685)) -- support history mode ([f095eb8](https://github.com/QingWei-Li/docsify/commit/f095eb8)) +#### Break change +- Remove `data-router`, `data-sidebar`, `data-sidebar-toggle` APIs diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md deleted file mode 100644 index 77d2ce7..0000000 --- a/CONTRIBUTING.md +++ /dev/null @@ -1,67 +0,0 @@ -# Contribute - -## Introduction - -First, thank you for considering contributing to docsify! It's people like you that make the open source community such a great community! 😊 - -We welcome any type of contribution, not only code. You can help with -- **QA**: file bug reports, the more details you can give the better (e.g. screenshots with the console open) -- **Marketing**: writing blog posts, howto's, printing stickers, ... -- **Community**: presenting the project at meetups, organizing a dedicated meetup for the local community, ... -- **Code**: take a look at the [open issues](issues). Even if you can't write code, commenting on them, showing that you care about a given issue matters. It helps us triage them. -- **Money**: we welcome financial contributions in full transparency on our [open collective](https://opencollective.com/docsify). - -## Your First Contribution - -Working on your first Pull Request? You can learn how from this *free* series, [How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github). - -## Submitting code - -Any code change should be submitted as a pull request. The description should explain what the code does and give steps to execute it. The pull request should also contain tests. - -## Code review process - -The bigger the pull request, the longer it will take to review and merge. Try to break down large pull requests in smaller chunks that are easier to review and merge. -It is also always helpful to have some context for your pull request. What was the purpose? Why does it matter to you? - -## Financial contributions - -We also welcome financial contributions in full transparency on our [open collective](https://opencollective.com/docsify). -Anyone can file an expense. If the expense makes sense for the development of the community, it will be "merged" in the ledger of our open collective by the core contributors and the person who filed the expense will be reimbursed. - -## Questions - -If you have any questions, create an [issue](issue) (protip: do a quick search first to see if someone else didn't ask the same question before!). -You can also reach us at hello@docsify.opencollective.com. - -## Credits - -### Contributors - -Thank you to all the people who have already contributed to docsify! - - - -### Backers - -Thank you to all our backers! [[Become a backer](https://opencollective.com/docsify#backer)] - - - - -### Sponsors - -Thank you to all our sponsors! (please ask your company to also support this open source project by [becoming a sponsor](https://opencollective.com/docsify#sponsor)) - - - - - - - - - - - - - \ No newline at end of file diff --git a/HISTORY.md b/HISTORY.md index fb720fd..d3cc3e3 100644 --- a/HISTORY.md +++ b/HISTORY.md @@ -1,736 +1,287 @@ +### 1.10.5 +#### Bug fixes +- fix initialize the Vue instance - -## [3.7.3](https://github.com/QingWei-Li/docsify/compare/v3.7.2...v3.7.3) (2017-05-22) +### 1.10.4 +#### Bug fixes +- fix execute script +### 1.10.3 +#### Bug fixes +- compatible vuep QingWei-Li/vuep/issues/2 +- fix sidebar scroll, fixed #63 -### Bug Fixes +### 1.10.2 +#### Bug fixes +- Fix render emojis again -* **render:** find => filter ([eca3368](https://github.com/QingWei-Li/docsify/commit/eca3368)) +### 1.10.1 +#### Bug fixes +- Fix render emojis +### 1.10.0 +#### Features +- Support emoji :laughing: +### 1.9.0 - -## [3.7.2](https://github.com/QingWei-Li/docsify/compare/v3.7.1...v3.7.2) (2017-05-19) +#### Bug fixes +- Destroys the vue instance when the route is changed +#### Features +- Add `!>` and `?>` doc helper. +#### Break change +- Remove `!` doc helper. - -## [3.7.1](https://github.com/QingWei-Li/docsify/compare/v3.7.0...v3.7.1) (2017-05-19) - - -### Bug Fixes - -* docsify-updated is undefined ([b2b4742](https://github.com/QingWei-Li/docsify/commit/b2b4742)) - - - - -# [3.7.0](https://github.com/QingWei-Li/docsify/compare/v3.6.6...v3.7.0) (2017-05-16) - +### 1.8.0 +#### Bug fixes +- Using `v-pre` skip compilation. ### Features +- Execute script when vue exists. -* add docsify-updated, close [#158](https://github.com/QingWei-Li/docsify/issues/158) ([d2be5ae](https://github.com/QingWei-Li/docsify/commit/d2be5ae)) -* add externalLinkTarget, close [#149](https://github.com/QingWei-Li/docsify/issues/149) ([2d73285](https://github.com/QingWei-Li/docsify/commit/2d73285)) +### 1.7.4 +#### Bug fixes +- Fix bugs caused by the previous version +### 1.7.3 +#### Bug fixes +- Add `hr` style +- Fixed option is an empty string +### 1.7.2 +#### Bug fixes +- Fix sidebar click event in mobile browser. - -## [3.6.6](https://github.com/QingWei-Li/docsify/compare/v3.6.5...v3.6.6) (2017-05-06) +### 1.7.1 +#### Bug fixes +- Fix sidebar style in mobile browser. +### 1.7.0 + +#### Bug fixes +- Fixed custom cover background, fixed #52 +- Fixed sticky sidebar ### Features +- Add `name` and `nameLink` -* support query string for the search, fixed [#156](https://github.com/QingWei-Li/docsify/issues/156) ([da75d70](https://github.com/QingWei-Li/docsify/commit/da75d70)) +### 1.6.1 +#### Bug fixes +- Fixed sidebar bug when the coverpage exist +### 1.6.0 +#### Features +- Improve sidebar performance. The active item is automatically scrolled in the visible view. +- New doc helper: `! `. e.g. `! content` will be rendered as `

content

` +### 1.5.2 +#### Bug fixes +- Fixed number at the beginning of the slug - -## [3.6.5](https://github.com/QingWei-Li/docsify/compare/v3.6.4...v3.6.5) (2017-04-28) +### 1.5.1 +#### Bug fixes +- Remove HTML tag when handling slug +### 1.5.0 -### Bug Fixes +#### Bug fixes +- Fix slugify. +- Fix nav highlight. -* **util:** fix crash, fixed [#154](https://github.com/QingWei-Li/docsify/issues/154) ([51832d3](https://github.com/QingWei-Li/docsify/commit/51832d3)) +#### Features +- Initialize the configuration by `window.$docsify`. +- Markdown parser is configurable. +### 1.4.3 +#### Bug fixes +- Tweak style. +### 1.4.2 - -## [3.6.4](https://github.com/QingWei-Li/docsify/compare/v3.6.3...v3.6.4) (2017-04-28) +#### Bug fixes +- Fix toggle button style. +- Support `mailto`, `tel`, etc. href type +- Fix scroll to top. -### Bug Fixes +### 1.4.1 +#### Bug fixes +- Fix generate slug. -* **util:** correctly clean up duplicate slashes, fixed [#153](https://github.com/QingWei-Li/docsify/issues/153) ([76c041a](https://github.com/QingWei-Li/docsify/commit/76c041a)) +### 1.4.0 Happly new year 🎉 +#### Features +- Display TOC in the custom sidebar, `data-sub-max-level`. +- Custom background in coverpage. +#### Bug fixes +- Fix scroll highlight when Vue exist. +### 1.3.5 +#### Bug fixes +- Fix vue - -## [3.6.3](https://github.com/QingWei-Li/docsify/compare/v3.6.2...v3.6.3) (2017-04-25) +### 1.3.4 +#### Bug fixes +- Supports [vuep](https://github.com/QingWei-Li/vuep) -### Bug Fixes +### 1.3.3 +#### Bug fixes +- Fixed cover rendering timing -* **external-script:** script attrs ([2653849](https://github.com/QingWei-Li/docsify/commit/2653849)) +### 1.3.2 +#### Bug fixes +- Fixed render link +### 1.3.1 - -## [3.6.2](https://github.com/QingWei-Li/docsify/compare/v3.6.0...v3.6.2) (2017-04-12) +#### Bug fixes +- Fixed cover page style +- Generate the correct link when rendering the article +### 1.3.0 +#### Features +- Add cover page +- add `` style +- headling can be cliked -### Features +#### Bug fixes +- sidebar highlight -* **event:** Collapse the sidebar when click outside element in the small screen ([9b7e5f5](https://github.com/QingWei-Li/docsify/commit/9b7e5f5)) -* **external-script:** detect more than one script dom, fixed [#146](https://github.com/QingWei-Li/docsify/issues/146) ([94d6603](https://github.com/QingWei-Li/docsify/commit/94d6603)) +#### break change +- Navbar no longer fixed at the top +### 1.2.0 +#### Features +- custom basePath +- custom homepage - -# [3.6.0](https://github.com/QingWei-Li/docsify/compare/v3.5.2...v3.6.0) (2017-04-09) +### 1.1.7 +#### Bug fixes +- Optimize progress bar +### 1.1.6 +#### Features +- Add logo 😂 -### Features +#### Bug fixes +- Remove table background color +- Fixed highlight sidebar using chinese ids -* **render:** add mergeNavbar option, close [#125](https://github.com/QingWei-Li/docsify/issues/125), [#124](https://github.com/QingWei-Li/docsify/issues/124) ([#145](https://github.com/QingWei-Li/docsify/issues/145)) ([9220523](https://github.com/QingWei-Li/docsify/commit/9220523)) +### 1.1.5 +#### Features +- Add table style +#### Bug fixes +- Not fixed position of hte navbar in the mobile browser +- Correct calculation of whether the mobile browser +### 1.1.4 +#### Bug fixes +- Fixed chinese auchor link - -## [3.5.2](https://github.com/QingWei-Li/docsify/compare/v3.5.1...v3.5.2) (2017-04-05) +### 1.1.3 +#### Bug fixes +- Optimize progress bar again +### 1.1.2 +#### Bug fixes +- fix failed `auto2top` in mobile - -## [3.5.1](https://github.com/QingWei-Li/docsify/compare/v3.5.0...v3.5.1) (2017-03-25) +### 1.1.1 +#### Bug fixes +- Optimize progress bar +### 1.1.0 +#### Features +- Add progress bar +- Add `auto2top` option for hash router -### Bug Fixes +### 1.0.3 +#### Bug fixes +- Fix cache -* .md file extension regex ([594299f](https://github.com/QingWei-Li/docsify/commit/594299f)) +### 1.0.2 +#### Bug fixes +- Fix binding events bug, fixed #24 +- Fix regular expression, fixed #23 +### 1.0.1 +#### Bug fixes +- `img` style +### 1.0.0 +#### Features +- Support hash router - -# [3.5.0](https://github.com/QingWei-Li/docsify/compare/v3.4.4...v3.5.0) (2017-03-25) +#### Bug fixes +- Improved scrolling on mobile +### 0.7.0 +#### Breaking change +- `themes/` was removed, only exists in the npm package. -### Bug Fixes +#### Bug fixes +- Fix style. +- Fix sidebar animation again. -* adjust display on small screens ([bf35471](https://github.com/QingWei-Li/docsify/commit/bf35471)) -* navbar labels for German ([b022aaf](https://github.com/QingWei-Li/docsify/commit/b022aaf)) +### 0.6.1 +#### Bug fixes +- In the mobile, it should collapse the sidebar when toggle is clicked. +- Fix the dropdown list style. +- Fix sidebar animation. +### 0.6.0 +#### Features +- Navbar support dropdown list, #6 +- Sidebar with toggle -### Features +#### Bug fixes +- Fix ineffective option, fixed #10 -* **route:** auto remove .md extension ([8f11653](https://github.com/QingWei-Li/docsify/commit/8f11653)) +### 0.5.0 +#### Features +- Custom sidebars and navbars by markdown file +### 0.4.2 +#### Bug fixes +- Correct catch ajax error +### 0.4.1 +#### Bug fixes +- catch ajax error + +### 0.4.0 +#### Features +- Custom sidebar - -## [3.4.4](https://github.com/QingWei-Li/docsify/compare/v3.4.3...v3.4.4) (2017-03-17) +#### Bug fixes +- Fix undefined language +### 0.3.1 +#### Bug fixes +- Strip HTML tag when rendering the headings -### Bug Fixes - -* **search:** fix input style ([2d6a51b](https://github.com/QingWei-Li/docsify/commit/2d6a51b)) - - - - -## [3.4.3](https://github.com/QingWei-Li/docsify/compare/v3.4.2...v3.4.3) (2017-03-16) - - - - -## [3.4.2](https://github.com/QingWei-Li/docsify/compare/v3.4.1...v3.4.2) (2017-03-11) - - -### Features - -* **emojify:** add no-emoji option ([3aef37a](https://github.com/QingWei-Li/docsify/commit/3aef37a)) - - - - -## [3.4.1](https://github.com/QingWei-Li/docsify/compare/v3.4.0...v3.4.1) (2017-03-10) - - -### Bug Fixes - -* **dom:** Disable the dom cache when vue is present, fixed [#119](https://github.com/QingWei-Li/docsify/issues/119) ([b9a7275](https://github.com/QingWei-Li/docsify/commit/b9a7275)) - - - - -# [3.4.0](https://github.com/QingWei-Li/docsify/compare/v3.3.0...v3.4.0) (2017-03-09) - - -### Features - -* **zoom-image:** add plugin ([50fa6fc](https://github.com/QingWei-Li/docsify/commit/50fa6fc)) - - - - -# [3.3.0](https://github.com/QingWei-Li/docsify/compare/v3.2.0...v3.3.0) (2017-03-07) - - - - -# [3.2.0](https://github.com/QingWei-Li/docsify/compare/v3.1.2...v3.2.0) (2017-02-28) - - -### Bug Fixes - -* **fetch:** load sidebar and navbar for parent path, fixed [#100](https://github.com/QingWei-Li/docsify/issues/100) ([f3fc596](https://github.com/QingWei-Li/docsify/commit/f3fc596)) -* **render:** Toc rendering error, fixed [#106](https://github.com/QingWei-Li/docsify/issues/106) ([0d59ee9](https://github.com/QingWei-Li/docsify/commit/0d59ee9)) - - -### Features - -* **search:** Localization for no data tip, close [#103](https://github.com/QingWei-Li/docsify/issues/103) ([d3c9fbd](https://github.com/QingWei-Li/docsify/commit/d3c9fbd)) - - - - -## [3.1.2](https://github.com/QingWei-Li/docsify/compare/v3.1.1...v3.1.2) (2017-02-27) - - - - -## [3.1.1](https://github.com/QingWei-Li/docsify/compare/v3.1.0...v3.1.1) (2017-02-24) - - -### Bug Fixes - -* **render:** custom cover background image ([8f9bf29](https://github.com/QingWei-Li/docsify/commit/8f9bf29)) -* **search:** don't search nameLink, fixed [#102](https://github.com/QingWei-Li/docsify/issues/102) ([507d9e8](https://github.com/QingWei-Li/docsify/commit/507d9e8)) -* **tpl:** extra character, fixed [#101](https://github.com/QingWei-Li/docsify/issues/101) ([d67d25f](https://github.com/QingWei-Li/docsify/commit/d67d25f)) - - - - -# [3.1.0](https://github.com/QingWei-Li/docsify/compare/v3.0.5...v3.1.0) (2017-02-22) - - -### Bug Fixes - -* **search:** incorrect anchor link, fixed [#90](https://github.com/QingWei-Li/docsify/issues/90) ([b8a3d8f](https://github.com/QingWei-Li/docsify/commit/b8a3d8f)) -* **sw:** update white list ([f2975a5](https://github.com/QingWei-Li/docsify/commit/f2975a5)) - - -### Features - -* **emoji:** add emoji plugin ([855c450](https://github.com/QingWei-Li/docsify/commit/855c450)) - - - - -## [3.0.5](https://github.com/QingWei-Li/docsify/compare/v3.0.4...v3.0.5) (2017-02-21) - - -### Bug Fixes - -* **event:** highlight sidebar when clicked, fixed [#86](https://github.com/QingWei-Li/docsify/issues/86) ([2a1157a](https://github.com/QingWei-Li/docsify/commit/2a1157a)) -* **gen-tree:** cache toc list, fixed [#88](https://github.com/QingWei-Li/docsify/issues/88) ([3394ebb](https://github.com/QingWei-Li/docsify/commit/3394ebb)) -* **layout.css:** loading style ([42b2dba](https://github.com/QingWei-Li/docsify/commit/42b2dba)) - - -### Features - -* **pwa:** add sw.js ([f7111b5](https://github.com/QingWei-Li/docsify/commit/f7111b5)) - - - - -## [3.0.4](https://github.com/QingWei-Li/docsify/compare/v3.0.3...v3.0.4) (2017-02-20) - - -### Bug Fixes - -* **render:** disable rendering sub list when loadSidebar is false ([35dd2e1](https://github.com/QingWei-Li/docsify/commit/35dd2e1)) -* **render:** execute script ([780c1e5](https://github.com/QingWei-Li/docsify/commit/780c1e5)) - - - - -## [3.0.3](https://github.com/QingWei-Li/docsify/compare/v3.0.2...v3.0.3) (2017-02-19) - - - - -## [3.0.2](https://github.com/QingWei-Li/docsify/compare/v3.0.1...v3.0.2) (2017-02-19) - - -### Bug Fixes - -* **compiler:** link ([3b127a1](https://github.com/QingWei-Li/docsify/commit/3b127a1)) -* **search:** add lazy input ([bf593a7](https://github.com/QingWei-Li/docsify/commit/bf593a7)) - - - - -## [3.0.1](https://github.com/QingWei-Li/docsify/compare/v3.0.0...v3.0.1) (2017-02-19) - - -### Bug Fixes - -* **route:** empty alias ([cd99b52](https://github.com/QingWei-Li/docsify/commit/cd99b52)) - - - - -# [3.0.0](https://github.com/QingWei-Li/docsify/compare/v2.4.3...v3.0.0) (2017-02-19) - - -### Bug Fixes - -* **compiler:** link ([c7e09c3](https://github.com/QingWei-Li/docsify/commit/c7e09c3)) -* **render:** support html file ([7b6a2ac](https://github.com/QingWei-Li/docsify/commit/7b6a2ac)) -* **search:** escape html ([fcb66e8](https://github.com/QingWei-Li/docsify/commit/fcb66e8)) -* **search:** fix default config ([2efd859](https://github.com/QingWei-Li/docsify/commit/2efd859)) - - -### Features - -* **front-matter:** add front matter[WIP] ([dbb9278](https://github.com/QingWei-Li/docsify/commit/dbb9278)) -* **render:** add auto header ([b7768b1](https://github.com/QingWei-Li/docsify/commit/b7768b1)) -* **search:** Localization for search placeholder, close [#80](https://github.com/QingWei-Li/docsify/issues/80) ([2351c3e](https://github.com/QingWei-Li/docsify/commit/2351c3e)) -* **themes:** add loading info ([86594a3](https://github.com/QingWei-Li/docsify/commit/86594a3)) - - - - -## [2.4.3](https://github.com/QingWei-Li/docsify/compare/v2.4.2...v2.4.3) (2017-02-15) - - - - -## [2.4.2](https://github.com/QingWei-Li/docsify/compare/v2.4.1...v2.4.2) (2017-02-14) - - -### Bug Fixes - -* **index:** load file path error ([dc536a3](https://github.com/QingWei-Li/docsify/commit/dc536a3)) - - - - -## [2.4.1](https://github.com/QingWei-Li/docsify/compare/v2.4.0...v2.4.1) (2017-02-13) - - -### Bug Fixes - -* **index:** cover page ([dd0c84b](https://github.com/QingWei-Li/docsify/commit/dd0c84b)) - - - - -# [2.4.0](https://github.com/QingWei-Li/docsify/compare/v2.3.0...v2.4.0) (2017-02-13) - - -### Features - -* **hook:** add doneEach ([c6f7602](https://github.com/QingWei-Li/docsify/commit/c6f7602)) - - - - -# [2.3.0](https://github.com/QingWei-Li/docsify/compare/v2.2.1...v2.3.0) (2017-02-13) - - -### Bug Fixes - -* **event:** has no effect on a FF mobile browser, fixed [#67](https://github.com/QingWei-Li/docsify/issues/67) ([0ff36c2](https://github.com/QingWei-Li/docsify/commit/0ff36c2)) -* **render:** custom marked renderer ([bf559b4](https://github.com/QingWei-Li/docsify/commit/bf559b4)) -* **render:** fix render link ([a866744](https://github.com/QingWei-Li/docsify/commit/a866744)) -* **render:** image url ([6f87529](https://github.com/QingWei-Li/docsify/commit/6f87529)) -* **render:** render link ([38ea660](https://github.com/QingWei-Li/docsify/commit/38ea660)) -* **src:** fix route ([324301a](https://github.com/QingWei-Li/docsify/commit/324301a)) -* **src:** get alias ([784173e](https://github.com/QingWei-Li/docsify/commit/784173e)) -* **src:** get alias ([ce99a04](https://github.com/QingWei-Li/docsify/commit/ce99a04)) -* **themes:** fix navbar style ([fa54b52](https://github.com/QingWei-Li/docsify/commit/fa54b52)) -* **themes:** update navbar style ([4864d1b](https://github.com/QingWei-Li/docsify/commit/4864d1b)) - - -### Features - -* **hook:** support custom plugin ([9e81a59](https://github.com/QingWei-Li/docsify/commit/9e81a59)) -* **src:** add alias feature ([24412cd](https://github.com/QingWei-Li/docsify/commit/24412cd)) -* **src:** dynamic title and fix sidebar style ([6b30eb6](https://github.com/QingWei-Li/docsify/commit/6b30eb6)) - - - - -## [2.2.1](https://github.com/QingWei-Li/docsify/compare/v2.2.0...v2.2.1) (2017-02-11) - - -### Bug Fixes - -* **event:** scroll active sidebar ([50f5fc2](https://github.com/QingWei-Li/docsify/commit/50f5fc2)) -* **search:** crash when not content, fixed [#68](https://github.com/QingWei-Li/docsify/issues/68) ([9d3cc89](https://github.com/QingWei-Li/docsify/commit/9d3cc89)) -* **search:** not work in mobile ([3941304](https://github.com/QingWei-Li/docsify/commit/3941304)) - - - - -# [2.2.0](https://github.com/QingWei-Li/docsify/compare/v2.1.0...v2.2.0) (2017-02-09) - - -### Features - -* **plugins:** add Google Analytics plugin ([#66](https://github.com/QingWei-Li/docsify/issues/66)) ([ac61bb0](https://github.com/QingWei-Li/docsify/commit/ac61bb0)) - - - - -# [2.1.0](https://github.com/QingWei-Li/docsify/compare/v2.0.3...v2.1.0) (2017-02-09) - - -### Bug Fixes - -* render name ([12e2479](https://github.com/QingWei-Li/docsify/commit/12e2479)) -* **vue.css:** update sidebar style ([fc140ef](https://github.com/QingWei-Li/docsify/commit/fc140ef)) - - -### Features - -* add search, close [#43](https://github.com/QingWei-Li/docsify/issues/43) ([eb5ff3e](https://github.com/QingWei-Li/docsify/commit/eb5ff3e)) - - - - -## [2.0.3](https://github.com/QingWei-Li/docsify/compare/v2.0.2...v2.0.3) (2017-02-07) - - -### Bug Fixes - -* css var polyfill ([8cd386a](https://github.com/QingWei-Li/docsify/commit/8cd386a)) -* css var polyfill ([cbaee21](https://github.com/QingWei-Li/docsify/commit/cbaee21)) -* rendering emojis ([8c7e4d7](https://github.com/QingWei-Li/docsify/commit/8c7e4d7)) - - - - -## [2.0.2](https://github.com/QingWei-Li/docsify/compare/v2.0.1...v2.0.2) (2017-02-05) - - -### Bug Fixes - -* button style in cover page ([4470855](https://github.com/QingWei-Li/docsify/commit/4470855)) - - - - -## [2.0.1](https://github.com/QingWei-Li/docsify/compare/v2.0.0...v2.0.1) (2017-02-05) - - - - -# [2.0.0](https://github.com/QingWei-Li/docsify/compare/v1.10.5...v2.0.0) (2017-02-05) - - -### Features - -* customize the theme color ([5cc9f05](https://github.com/QingWei-Li/docsify/commit/5cc9f05)) - - - - -## [1.10.5](https://github.com/QingWei-Li/docsify/compare/v1.10.4...v1.10.5) (2017-01-28) - - - - -## [1.10.4](https://github.com/QingWei-Li/docsify/compare/v1.10.3...v1.10.4) (2017-01-27) - - - - -## [1.10.3](https://github.com/QingWei-Li/docsify/compare/v1.10.2...v1.10.3) (2017-01-27) - - - - -## [1.10.2](https://github.com/QingWei-Li/docsify/compare/v1.10.1...v1.10.2) (2017-01-25) - - - - -## [1.10.1](https://github.com/QingWei-Li/docsify/compare/v1.10.0...v1.10.1) (2017-01-25) - - - - -# [1.10.0](https://github.com/QingWei-Li/docsify/compare/v1.9.0...v1.10.0) (2017-01-25) - - - - -# [1.9.0](https://github.com/QingWei-Li/docsify/compare/v1.8.0...v1.9.0) (2017-01-24) - - - - -# [1.8.0](https://github.com/QingWei-Li/docsify/compare/v1.7.4...v1.8.0) (2017-01-24) - - - - -## [1.7.4](https://github.com/QingWei-Li/docsify/compare/v1.7.3...v1.7.4) (2017-01-13) - - - - -## [1.7.3](https://github.com/QingWei-Li/docsify/compare/v1.7.2...v1.7.3) (2017-01-13) - - - - -## [1.7.2](https://github.com/QingWei-Li/docsify/compare/v1.7.1...v1.7.2) (2017-01-12) - - - - -## [1.7.1](https://github.com/QingWei-Li/docsify/compare/v1.7.0...v1.7.1) (2017-01-12) - - - - -# [1.7.0](https://github.com/QingWei-Li/docsify/compare/v1.6.1...v1.7.0) (2017-01-12) - - - - -## [1.6.1](https://github.com/QingWei-Li/docsify/compare/v1.6.0...v1.6.1) (2017-01-10) - - - - -# [1.6.0](https://github.com/QingWei-Li/docsify/compare/v1.5.2...v1.6.0) (2017-01-10) - - - - -## [1.5.2](https://github.com/QingWei-Li/docsify/compare/v1.5.1...v1.5.2) (2017-01-10) - - - - -## [1.5.1](https://github.com/QingWei-Li/docsify/compare/v1.5.0...v1.5.1) (2017-01-09) - - - - -# [1.5.0](https://github.com/QingWei-Li/docsify/compare/v1.4.3...v1.5.0) (2017-01-04) - - -### Features - -* Markdown parser is configurable, [#42](https://github.com/QingWei-Li/docsify/issues/42) ([8b1000a](https://github.com/QingWei-Li/docsify/commit/8b1000a)) - - - - -## [1.4.3](https://github.com/QingWei-Li/docsify/compare/v1.4.2...v1.4.3) (2017-01-01) - - - - -## [1.4.2](https://github.com/QingWei-Li/docsify/compare/v1.4.1...v1.4.2) (2016-12-31) - - - - -## [1.4.1](https://github.com/QingWei-Li/docsify/compare/v1.4.0...v1.4.1) (2016-12-31) - - - - -# [1.4.0](https://github.com/QingWei-Li/docsify/compare/v1.3.5...v1.4.0) (2016-12-31) - - - - -## [1.3.5](https://github.com/QingWei-Li/docsify/compare/v1.3.4...v1.3.5) (2016-12-25) - - - - -## [1.3.4](https://github.com/QingWei-Li/docsify/compare/v1.3.3...v1.3.4) (2016-12-25) - - - - -## [1.3.3](https://github.com/QingWei-Li/docsify/compare/v1.3.2...v1.3.3) (2016-12-23) - - - - -## [1.3.2](https://github.com/QingWei-Li/docsify/compare/v1.3.1...v1.3.2) (2016-12-22) - - - - -## [1.3.1](https://github.com/QingWei-Li/docsify/compare/v1.3.0...v1.3.1) (2016-12-22) - - - - -# [1.3.0](https://github.com/QingWei-Li/docsify/compare/v1.2.0...v1.3.0) (2016-12-21) - - - - -# [1.2.0](https://github.com/QingWei-Li/docsify/compare/v1.1.7...v1.2.0) (2016-12-20) - - - - -## [1.1.7](https://github.com/QingWei-Li/docsify/compare/v1.1.6...v1.1.7) (2016-12-19) - - - - -## [1.1.6](https://github.com/QingWei-Li/docsify/compare/v1.1.5...v1.1.6) (2016-12-18) - - - - -## [1.1.5](https://github.com/QingWei-Li/docsify/compare/v1.1.4...v1.1.5) (2016-12-18) - - - - -## [1.1.4](https://github.com/QingWei-Li/docsify/compare/v1.1.3...v1.1.4) (2016-12-17) - - - - -## [1.1.3](https://github.com/QingWei-Li/docsify/compare/v1.1.2...v1.1.3) (2016-12-17) - - - - -## [1.1.2](https://github.com/QingWei-Li/docsify/compare/v1.1.1...v1.1.2) (2016-12-17) - - - - -## [1.1.1](https://github.com/QingWei-Li/docsify/compare/v1.1.0...v1.1.1) (2016-12-17) - - - - -# [1.1.0](https://github.com/QingWei-Li/docsify/compare/v1.0.3...v1.1.0) (2016-12-16) - - - - -## [1.0.3](https://github.com/QingWei-Li/docsify/compare/v1.0.2...v1.0.3) (2016-12-13) - - - - -## [1.0.2](https://github.com/QingWei-Li/docsify/compare/v1.0.1...v1.0.2) (2016-12-13) - - - - -## [1.0.1](https://github.com/QingWei-Li/docsify/compare/v1.0.0...v1.0.1) (2016-12-08) - - - - -# [1.0.0](https://github.com/QingWei-Li/docsify/compare/v0.7.0...v1.0.0) (2016-12-08) - - - - -# [0.7.0](https://github.com/QingWei-Li/docsify/compare/v0.6.1...v0.7.0) (2016-11-30) - - - - -## [0.6.1](https://github.com/QingWei-Li/docsify/compare/v0.6.0...v0.6.1) (2016-11-29) - - - - -# [0.6.0](https://github.com/QingWei-Li/docsify/compare/v0.5.0...v0.6.0) (2016-11-29) - - - - -# [0.5.0](https://github.com/QingWei-Li/docsify/compare/v0.4.2...v0.5.0) (2016-11-28) - - - - -## [0.4.2](https://github.com/QingWei-Li/docsify/compare/v0.4.1...v0.4.2) (2016-11-28) - - - - -## [0.4.1](https://github.com/QingWei-Li/docsify/compare/v0.4.0...v0.4.1) (2016-11-28) - - - - -# [0.4.0](https://github.com/QingWei-Li/docsify/compare/v0.3.1...v0.4.0) (2016-11-27) - - -### Features - -* custom sidebar, [#4](https://github.com/QingWei-Li/docsify/issues/4) ([#5](https://github.com/QingWei-Li/docsify/issues/5)) ([37e7984](https://github.com/QingWei-Li/docsify/commit/37e7984)) - - - - -## [0.3.1](https://github.com/QingWei-Li/docsify/compare/v0.3.0...v0.3.1) (2016-11-27) - - - - -# [0.3.0](https://github.com/QingWei-Li/docsify/compare/v0.2.1...v0.3.0) (2016-11-27) - - - - -## [0.2.1](https://github.com/QingWei-Li/docsify/compare/v0.2.0...v0.2.1) (2016-11-26) - - - - -# [0.2.0](https://github.com/QingWei-Li/docsify/compare/v0.1.0...v0.2.0) (2016-11-26) - - - - -# [0.1.0](https://github.com/QingWei-Li/docsify/compare/v0.0.5...v0.1.0) (2016-11-26) - - - - -## [0.0.5](https://github.com/QingWei-Li/docsify/compare/v0.0.4...v0.0.5) (2016-11-24) - - - - -## [0.0.4](https://github.com/QingWei-Li/docsify/compare/v0.0.3...v0.0.4) (2016-11-22) - - - - -## [0.0.3](https://github.com/QingWei-Li/docsify/compare/v0.0.2...v0.0.3) (2016-11-20) - - - - -## [0.0.2](https://github.com/QingWei-Li/docsify/compare/v0.0.1...v0.0.2) (2016-11-20) - - - - -## 0.0.1 (2016-11-20) +### 0.3.0 +#### Features +- Add minified css files +- Add max level option +- Add pure.css + +### 0.2.1 +#### Bug fixes +- Fix vue.css + +### 0.2.0 +#### Bug fixes +- Fix route +- Remove dynamic title + +### 0.1.0 +#### Features +- Add buble.css \ No newline at end of file diff --git a/LICENSE b/LICENSE index 37a4ac5..58492da 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2016 - present cinwell.li +Copyright (c) 2016 - 2017 cinwell.li Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index b8da0d8..88937d1 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@

- docsify + docsify

@@ -9,60 +9,59 @@

- Backers on Open Collective - Sponsors on Open Collective - Travis Status + Travis Status npm donate - gitter -

- -

Gold Sponsor via Open Collective

- -

- - -

## Links - -- [`develop` branch preview](https://docsifyjs.netlify.com/) - [Documentation](https://docsify.js.org) -- [CLI](https://github.com/docsifyjs/docsify-cli) -- CDN: [UNPKG](https://unpkg.com/docsify/) | [jsDelivr](https://cdn.jsdelivr.net/npm/docsify/) | [cdnjs](https://cdnjs.com/libraries/docsify) -- [Awesome docsify](https://github.com/docsifyjs/awesome-docsify) -- [Community chat](https://gitter.im/docsifyjs/Lobby) +- [CLI](https://github.com/QingWei-Li/docsify-cli) ## Features - -- No statically built html files -- Simple and lightweight (~21kB gzipped) +- Not build static html files +- Simple and lightweight (~13kB gzipped) - Smart full-text search plugin - Multiple themes - Useful plugin API -- Compatible with IE11 -- Support SSR ([example](https://github.com/docsifyjs/docsify-ssr-demo)) -- Support embedded files +- Compatible with IE9+ ## Quick start +Create a `index.html`. -Look at [this tutorial](https://docsify.js.org/#/quickstart) +index.html -[![Edit 307qqv236](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/307qqv236) +```html + + + + + + + +
+ + + +``` + +## Browser Support + +Modern browsers and Internet Explorer 9+. ## Showcase +These open-source projects are using docsify to generate their sites. Pull requests welcome : ) -These projects are using docsify to generate their sites. Pull requests welcome :blush: - -Move to [awesome-docsify](https://github.com/docsifyjs/awesome-docsify#showcase) +- [Snipaste](https://docs.snipaste.com/) - A new way to boost your productivity. +- [puck](https://puck.zz173.com/) - A small & magical php framework. +- [Samaritan](http://samaritan.stockdb.org) - An Algorithmic Trading Framework for Digital Currency. +- [Vudash](http://vudash.github.io/vudash/) - Powerful, Flexible, Open Source dashboards for anything +- [Trilogy](http://trilogy.js.org) - No-hassle SQLite with a Promise-based, document store style API. +- [Mybatis-Plus](http://mp.baomidou.com/) - An enhanced toolkit of Mybatis to simplify development ## Similar projects - -| Project | Description | -| ------------------------------------------------ | ---------------------------------------- | -| [docute](https://github.com/egoist/docute) | 📜 Effortlessly documentation done right | -| [docpress](https://github.com/docpress/docpress) | Documentation website generator | +- [docute](https://github.com/egoist/docute) - 📜 Effortlessly documentation done right +- [docpress](https://github.com/docpress/docpress) - Documentation website generator ## Contributing @@ -70,42 +69,15 @@ Move to [awesome-docsify](https://github.com/docsifyjs/awesome-docsify#showcase) - Create your feature branch: `git checkout -b my-new-feature` - Commit your changes: `git commit -am 'Add some feature'` - Push to the branch: `git push origin my-new-feature` -- Submit a pull request +- Submit a pull request :D + ## Development ```bash -npm run bootstrap && npm run dev +npm i && npm run dev +open http://localhost:3000 ``` -## Backers - -Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/docsify#backers)] - - - -## Sponsors - -Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/docsify#silver-sponsors)] - - - - - - - - - - - - -## Contributors - -This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)]. - - ## License - -[MIT](LICENSE) - -[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fdocsifyjs%2Fdocsify.svg?type=large)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fdocsifyjs%2Fdocsify?ref=badge_large) +MIT diff --git a/app.js b/app.js new file mode 100644 index 0000000..beada16 --- /dev/null +++ b/app.js @@ -0,0 +1,12 @@ +var serveStatic = require('serve-static') +var http = require('http') +var fs = require('fs') + +http.createServer(function (req, res) { + serveStatic('.')(req, res, function () { + res.writeHead(404, { 'Content-Type': 'text/html' }) + res.end(fs.readFileSync('dev.html')) + }) +}).listen(3000, '0.0.0.0') + +console.log(`\nListening at http://0.0.0.0:3000\n`) diff --git a/build/build-css.js b/build/build-css.js new file mode 100644 index 0000000..40672e0 --- /dev/null +++ b/build/build-css.js @@ -0,0 +1,47 @@ +var fs = require('fs') +var cssnano = require('cssnano').process +var resolve = require('path').resolve +var postcss = require('postcss') +var isProd = process.argv[process.argv.length - 1] !== '--dev' + +var processor = postcss([require('postcss-salad')({ + features: { + precss: { + properties: { + preserve: true + } + } + } +})]) + +var saveMin = function (file, content) { + fs.writeFileSync(resolve(__dirname, '../lib/themes/', file), content) +} +var save = function (file, content) { + fs.writeFileSync(resolve(__dirname, '../themes/', file), content) +} +var load = function (file) { + return fs.readFileSync(resolve(__dirname, '../src/themes/', file)).toString() +} +var loadLib = function (file) { + return fs.readFileSync(resolve(__dirname, '../themes/', file)).toString() +} + +var list = fs.readdirSync(resolve(__dirname, '../src/themes')) + +list.forEach(function (file) { + if (!/\.css$/.test(file)) return + processor.process(load(file), { from: resolve(__dirname, '../src/themes/', file) }) + .then(function (result) { + save(file, result.css) + console.log('salad - ' + file) + isProd && cssnano(loadLib(file)) + .then(function (result) { + saveMin(file, result.css) + console.log('cssnao - ' + file) + }) + }).catch(function (err) { + console.log(err) + }) +}) + diff --git a/build/build.js b/build/build.js index 7b61224..cbeefc9 100644 --- a/build/build.js +++ b/build/build.js @@ -1,119 +1,60 @@ -const rollup = require('rollup') -const buble = require('rollup-plugin-buble') -const commonjs = require('rollup-plugin-commonjs') -const nodeResolve = require('rollup-plugin-node-resolve') -const uglify = require('rollup-plugin-uglify') -const replace = require('rollup-plugin-replace') -const isProd = process.env.NODE_ENV === 'production' -const version = process.env.VERSION || require('../package.json').version -const chokidar = require('chokidar') -const path = require('path') +var rollup = require('rollup') +var buble = require('rollup-plugin-buble') +var commonjs = require('rollup-plugin-commonjs') +var nodeResolve = require('rollup-plugin-node-resolve') +var uglify = require('rollup-plugin-uglify') +var isProd = process.argv[process.argv.length - 1] !== '--dev' -const build = function (opts) { +var build = function (opts) { rollup .rollup({ - input: opts.input, - plugins: (opts.plugins || []).concat([ - buble(), - commonjs(), - nodeResolve(), - replace({ - __VERSION__: version, - 'process.env.SSR': false - }) - ]) + entry: 'src/' + opts.entry, + plugins: [buble()].concat(opts.plugins || []) }) .then(function (bundle) { - var dest = 'lib/' + (opts.output || opts.input) + var dest = 'lib/' + (opts.output || opts.entry) console.log(dest) bundle.write({ format: 'iife', - file: dest, - strict: false + moduleName: opts.moduleName || 'D', + dest: dest }) }) .catch(function (err) { console.error(err) }) } -const buildCore = function () { - build({ - input: 'src/core/index.js', - output: 'docsify.js' - }) - if (isProd) { - build({ - input: 'src/core/index.js', - output: 'docsify.min.js', - plugins: [uglify()] - }) - } -} -const buildAllPlugin = function () { - var plugins = [ - {name: 'search', input: 'search/index.js'}, - {name: 'ga', input: 'ga.js'}, - {name: 'matomo', input: 'matomo.js'}, - {name: 'emoji', input: 'emoji.js'}, - {name: 'external-script', input: 'external-script.js'}, - {name: 'front-matter', input: 'front-matter/index.js'}, - {name: 'zoom-image', input: 'zoom-image.js'}, - {name: 'disqus', input: 'disqus.js'}, - {name: 'gitalk', input: 'gitalk.js'} - ] - - plugins.forEach(item => { - build({ - input: 'src/plugins/' + item.input, - output: 'plugins/' + item.name + '.js' - }) - }) - - if (isProd) { - plugins.forEach(item => { - build({ - input: 'src/plugins/' + item.input, - output: 'plugins/' + item.name + '.min.js', - plugins: [uglify()] - }) - }) - } -} - -if (!isProd) { - chokidar - .watch(['src/core', 'src/plugins'], { - atomic: true, - awaitWriteFinish: { - stabilityThreshold: 1000, - pollInterval: 100 - } - }) - .on('change', p => { - console.log('[watch] ', p) - const dirs = p.split(path.sep) - if (dirs[1] === 'core') { - buildCore() - } else if (dirs[2]) { - const name = path.basename(dirs[2], '.js') - const input = `src/plugins/${name}${ - /\.js/.test(dirs[2]) ? '' : '/index' - }.js` - - build({ - input, - output: 'plugins/' + name + '.js' - }) - } - }) - .on('ready', () => { - console.log('[start]') - buildCore() - buildAllPlugin() - }) -} else { - buildCore() - buildAllPlugin() -} +build({ + entry: 'index.js', + output: 'docsify.js', + plugins: [commonjs(), nodeResolve()] +}) +isProd && build({ + entry: 'index.js', + output: 'docsify.min.js', + plugins: [commonjs(), nodeResolve(), uglify()] +}) +build({ + entry: 'plugins/search.js', + output: 'plugins/search.js', + moduleName: 'D.Search' +}) +isProd && build({ + entry: 'plugins/search.js', + output: 'plugins/search.min.js', + moduleName: 'D.Search', + plugins: [uglify()] +}) +build({ + entry: 'plugins/ga.js', + output: 'plugins/ga.js', + moduleName: 'D.GA' +}) +isProd && build({ + entry: 'plugins/ga.js', + output: 'plugins/ga.min.js', + moduleName: 'D.GA', + plugins: [uglify()] +}) diff --git a/build/cover.js b/build/cover.js deleted file mode 100644 index fbd27f7..0000000 --- a/build/cover.js +++ /dev/null @@ -1,14 +0,0 @@ -var fs = require('fs') -var read = fs.readFileSync -var write = fs.writeFileSync -var version = process.env.VERSION || require('../package.json').version - -var file = __dirname + '/../docs/_coverpage.md' -var cover = read(file, 'utf8').toString() - -console.log('Replace version number in cover page...') -cover = cover.replace( - /(\S+)?<\/small>/g, - '' + version + '' -) -write(file, cover) diff --git a/build/mincss.js b/build/mincss.js deleted file mode 100644 index f6c5ec2..0000000 --- a/build/mincss.js +++ /dev/null @@ -1,12 +0,0 @@ -const cssnano = require('cssnano').process -const path = require('path') -const fs = require('fs') - -files = fs.readdirSync(path.resolve('lib/themes')) - -files.forEach(file => { - file = path.resolve('lib/themes', file) - cssnano(fs.readFileSync(file)).then(result => { - fs.writeFileSync(file, result.css) - }) -}) diff --git a/build/release.sh b/build/release.sh deleted file mode 100755 index a328322..0000000 --- a/build/release.sh +++ /dev/null @@ -1,50 +0,0 @@ -set -e - -if [[ -z $1 ]]; then - echo "Enter new version: " - read VERSION -else - VERSION=$1 -fi - -read -p "Releasing $VERSION $RELEASE_TAG - are you sure? (y/n) " -n 1 -r -echo -if [[ $REPLY =~ ^[Yy]$ ]]; then - echo "Releasing $VERSION ..." - - npm run test - - # build - VERSION=$VERSION npm run build - - # update packages - cd packages/docsify-server-renderer - npm version $VERSION - if [[ -z $RELEASE_TAG ]]; then - npm publish - else - npm publish --tag $RELEASE_TAG - fi - cd - - - # commit - git add -A - git commit -m "[build] $VERSION $RELEASE_TAG" - npm --no-git-tag-version version $VERSION --message "[release] $VERSION $RELEASE_TAG" - - # changelog - node_modules/.bin/conventional-changelog -p angular -i CHANGELOG.md -s - - git add . - git commit -m "chore: add changelog $VERSION" - - # publish - git tag v$VERSION - git push origin refs/tags/v$VERSION - git push - if [[ -z $RELEASE_TAG ]]; then - npm publish - else - npm publish --tag $RELEASE_TAG - fi -fi diff --git a/build/ssr.js b/build/ssr.js deleted file mode 100644 index 16b93ca..0000000 --- a/build/ssr.js +++ /dev/null @@ -1,34 +0,0 @@ -var rollup = require('rollup') -var buble = require('rollup-plugin-buble') -var async = require('rollup-plugin-async') -var replace = require('rollup-plugin-replace') - -rollup - .rollup({ - input: 'packages/docsify-server-renderer/index.js', - plugins: [ - async(), - replace({ - __VERSION__: process.env.VERSION || require('../package.json').version, - 'process.env.SSR': true - }), - buble({ - transforms: { - generator: false - } - }) - ], - onwarn: function () {} - }) - .then(function (bundle) { - var dest = 'packages/docsify-server-renderer/build.js' - - console.log(dest) - bundle.write({ - format: 'cjs', - file: dest - }) - }) - .catch(function (err) { - console.error(err) - }) diff --git a/dev.html b/dev.html new file mode 100644 index 0000000..54becd0 --- /dev/null +++ b/dev.html @@ -0,0 +1,34 @@ + + + + + docsify + + + + + +
+ + + + diff --git a/docs/README.md b/docs/README.md index e625420..31602ab 100644 --- a/docs/README.md +++ b/docs/README.md @@ -2,31 +2,26 @@ > A magical documentation site generator. -## What it is +## What is it -docsify generates your documentation website on the fly. Unlike GitBook, it does not generate static html files. Instead, it smartly loads and parses your Markdown files and displays them as a website. To start using it, all you need to do is create an `index.html` and [deploy it on GitHub Pages](deploy.md). +docsify generates your documentation website on the fly. Unlike GitBook, it does not generate static html files. It smartly loads and parses your Markdown files and displays them in website. All you need to do is create an `index.html` to start and [deploy it on GitHub Pages](/deploy). -See the [Quick start](quickstart.md) guide for more details. +See the [Quick start](/quickstart) for more details. ## Features -- No statically built html files -- Simple and lightweight (~21kB gzipped) +- Not build static html files +- Simple and lightweight (~13kB gzipped) - Smart full-text search plugin - Multiple themes - Useful plugin API -- Emoji support -- Compatible with IE11 -- Support server-side rendering ([example](https://github.com/docsifyjs/docsify-ssr-demo)) +- Compatible with IE9+ ## Examples -Check out the [Showcase](https://github.com/docsifyjs/awesome-docsify#showcase) to see docsify in use. +Check out the [Showcase](https://github.com/QingWei-Li/docsify/#showcase) to see use the docsify generated website. ## Donate -Please consider donating if you think docsify is helpful to you or that my work is valuable. I am happy if you can help me [buy a cup of coffee](https://github.com/QingWei-Li/donate). :heart: +If you think docsify is helpful to you or that my work is valuable. I am happy if you can help me [buy a cup of coffee](https://github.com/QingWei-Li/donate). :heart: -## Community - -Users and the development team are usually in the [Gitter chat room](https://gitter.im/docsifyjs/Lobby). diff --git a/docs/_coverpage.md b/docs/_coverpage.md index 1decbd6..74b8f32 100644 --- a/docs/_coverpage.md +++ b/docs/_coverpage.md @@ -1,12 +1,13 @@ ![logo](_media/icon.svg) -# docsify 4.9.4 +# docsify 2.3.0 > A magical documentation site generator. -- Simple and lightweight (~21kB gzipped) -- No statically built html files +- Simple and lightweight (~13kB gzipped) +- Not build static html files - Multiple themes -[GitHub](https://github.com/docsifyjs/docsify/) -[Getting Started](#docsify) + +[GitHub](https://github.com/QingWei-Li/docsify/) +[Get Started](#quick-start) diff --git a/docs/_media/example.html b/docs/_media/example.html deleted file mode 100644 index d35ee16..0000000 --- a/docs/_media/example.html +++ /dev/null @@ -1 +0,0 @@ -

To infinity and Beyond!

\ No newline at end of file diff --git a/docs/_media/example.js b/docs/_media/example.js deleted file mode 100644 index 7b6f668..0000000 --- a/docs/_media/example.js +++ /dev/null @@ -1,16 +0,0 @@ -import fetch from 'fetch' - -const URL = 'https://example.com' -const PORT = 8080 - -/// [demo] -const result = fetch(`${URL}:${PORT}`) - .then(function(response) { - return response.json(); - }) - .then(function(myJson) { - console.log(JSON.stringify(myJson)); - }); -/// [demo] - -result.then(console.log).catch(console.error) diff --git a/docs/_media/example.md b/docs/_media/example.md deleted file mode 100644 index 6ee6494..0000000 --- a/docs/_media/example.md +++ /dev/null @@ -1 +0,0 @@ -> This is from the `example.md` diff --git a/docs/_navbar.md b/docs/_navbar.md deleted file mode 100644 index 47a2356..0000000 --- a/docs/_navbar.md +++ /dev/null @@ -1,6 +0,0 @@ -- Translations - - [:uk: English](/) - - [:cn: 中文](/zh-cn/) - - [:de: Deutsch](/de-de/) - - [:es: Spanish](/es/) - - [:ru: Russian](/ru/) diff --git a/docs/_sidebar.md b/docs/_sidebar.md index 051514b..76261f0 100644 --- a/docs/_sidebar.md +++ b/docs/_sidebar.md @@ -1,28 +1,20 @@ - Getting started + - [Quick start](/quickstart) + - [Writing more pages](/more-pages) + - [Custom navbar](/custom-navbar) + - [Cover page](/cover) - - [Quick start](quickstart.md) - - [Writing more pages](more-pages.md) - - [Custom navbar](custom-navbar.md) - - [Cover page](cover.md) - -- Customization - - - [Configuration](configuration.md) - - [Themes](themes.md) - - [List of Plugins](plugins.md) - - [Write a Plugin](write-a-plugin.md) - - [Markdown configuration](markdown.md) - - [Language highlighting](language-highlight.md) +- Configuration + - [Configuration](/configuration) + - [Themes](/themes) + - [Using plugins](/plugins) + - [Markdown configuration](/markdown) + - [Lanuage highlight](/language-highlight) - Guide + - [Deploy](/deploy) + - [Doc helper](/helpers) + - [Compatible Vue](/vue) + - [CDN](/cdn) - - [Deploy](deploy.md) - - [Helpers](helpers.md) - - [Vue compatibility](vue.md) - - [CDN](cdn.md) - - [Offline Mode(PWA)](pwa.md) - - [Server-Side Rendering(SSR)](ssr.md) - - [Embed Files](embed-files.md) - -- [Awesome docsify](awesome.md) -- [Changelog](changelog.md) +- [Changelog](/changelog) \ No newline at end of file diff --git a/docs/cdn.md b/docs/cdn.md index eba77a8..1e0b2ec 100644 --- a/docs/cdn.md +++ b/docs/cdn.md @@ -2,8 +2,10 @@ Recommended: [unpkg](//unpkg.com), which will reflect the latest version as soon as it is published to npm. You can also browse the source of the npm package at [unpkg.com/docsify/](//unpkg.com/docsify/). + ## Latest version + ```html @@ -12,10 +14,9 @@ Recommended: [unpkg](//unpkg.com), which will reflect the latest version as soon ``` -Alternatively, use [compressed files](#compressed-file). - ## Specific version + ```html @@ -26,6 +27,7 @@ Alternatively, use [compressed files](#compressed-file). ## Compressed file + ```html @@ -34,17 +36,7 @@ Alternatively, use [compressed files](#compressed-file). ``` -```html - - - - - -``` - ## Other CDN -- http://www.bootcdn.cn/docsify -- https://cdn.jsdelivr.net/npm/docsify/ -- https://cdnjs.com/libraries/docsify +[jsDelivr](http://www.jsdelivr.com/projects/docsify) is available. diff --git a/docs/configuration.md b/docs/configuration.md index ba48475..5af2515 100644 --- a/docs/configuration.md +++ b/docs/configuration.md @@ -1,17 +1,30 @@ # Configuration -You can configure the `window.$docsify`. +docsify supports two ways to configure. You can configure the `window.$docsify` or write configuration on the script tag via `data-*` attributes. ```html + + + + ``` +Both ways are compatible. However, the first way is recommended. It is clear and can be configured in a separate file. + +!> In `window.$docsfiy`, the options should be written by camelCase. + ## el - Type: `String` @@ -22,7 +35,7 @@ The DOM element to be mounted on initialization. It can be a CSS selector string ```js window.$docsify = { el: '#app' -}; +} ``` ## repo @@ -34,13 +47,14 @@ Configure the repository url or a string of `username/repo` can add the [GitHub ```js window.$docsify = { - repo: 'docsifyjs/docsify', + repo: 'QingWei-Li/docsify', // or - repo: 'https://github.com/docsifyjs/docsify/' -}; + repo: 'https://github.com/QingWei-Li/docsify/' +} ``` -## maxLevel + +## max-level - Type: `Number` - Default: `6` @@ -50,15 +64,15 @@ Maximum Table of content level. ```js window.$docsify = { maxLevel: 4 -}; +} ``` -## loadNavbar +## load-navbar - Type: `Boolean|String` - Default: `false` -Loads navbar from the Markdown file `_navbar.md` if **true**, or else from the path specified. +Load navbar from Markdown file. If **true** it will be loaded from `_navbar.md`. ```js window.$docsify = { @@ -67,15 +81,16 @@ window.$docsify = { // load from nav.md loadNavbar: 'nav.md' -}; +} ``` -## loadSidebar +## load-sidebar - Type: `Boolean|String` - Default: `false` -Loads sidebar from the Markdown file `_sidebar.md` if **true**, or else from the path specified. + +Load sidebar from Markdown file. If **true** it will be loaded from `_sidebar.md`. ```js window.$docsify = { @@ -84,40 +99,44 @@ window.$docsify = { // load from summary.md loadSidebar: 'summary.md' -}; +} ``` -## subMaxLevel +## sub-max-level - Type: `Number` - Default: `0` -Add table of contents (TOC) in custom sidebar. +Add TOC in custom sidebar. ```js window.$docsify = { - subMaxLevel: 2 -}; + subMaxLevel: 3 +} ``` + ## auto2top - Type: `Boolean` - Default: `false` + Scrolls to the top of the screen when the route is changed. ```js window.$docsify = { auto2top: true -}; +} ``` + ## homepage - Type: `String` - Default: `README.md` + `README.md` in your docs folder will be treated as homepage for your website, but sometimes you may need to serve another file as your homepage. ```js @@ -126,12 +145,11 @@ window.$docsify = { homepage: 'home.md', // Or use the readme in your repo - homepage: - 'https://raw.githubusercontent.com/docsifyjs/docsify/master/README.md' -}; + homepage: 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/README.md' +} ``` -## basePath +## base-path - Type: `String` @@ -145,101 +163,41 @@ window.$docsify = { basePath: 'https://docsify.js.org/', // Even can load files from other repo - basePath: - 'https://raw.githubusercontent.com/ryanmcdermott/clean-code-javascript/master/' -}; + basePath: 'https://raw.githubusercontent.com/ryanmcdermott/clean-code-javascript/master/' +} ``` -## relativePath - -- Type: `Boolean` -- Default: `false` - -If **true** links are relative to the current context. - -For example, the directory structure is as follows: - -```text -. -└── docs - ├── README.md - ├── guide.md - └── zh-cn - ├── README.md - ├── guide.md - └── config - └── example.md -``` - -With relative path **enabled** and current URL `http://domain.com/zh-cn/README`, given links will resolve to: - -```text -guide.md => http://domain.com/zh-cn/guide -config/example.md => http://domain.com/zh-cn/config/example -../README.md => http://domain.com/README -/README.md => http://domain.com/README -``` - -```js -window.$docsify = { - // Relative path enabled - relativePath: true, - - // Relative path disabled (default value) - relativePath: false -}; -``` ## coverpage -- Type: `Boolean|String|String[]|Object` +- Type: `Boolean|String` - Default: `false` -Activate the [cover feature](cover.md). If true, it will load from `_coverpage.md`. +Activate the [cover feature](/cover). If ture, it will load from `_coverpage.md`. ```js window.$docsify = { coverpage: true, // Custom file name - coverpage: 'cover.md', - - // mutiple covers - coverpage: ['/', '/zh-cn/'], - - // mutiple covers and custom file name - coverpage: { - '/': 'cover.md', - '/zh-cn/': 'cover.md' - } -}; -``` - -## logo - -- Type: `String` - -Website logo as it appears in the sidebar, you can resize by CSS. - -```js -window.$docsify = { - logo: '/_media/icon.svg' -}; + coverpage: 'cover.md' +} ``` ## name - Type: `String` -Website name as it appears in the sidebar. + +Website name appears in the sidebar. ```js window.$docsify = { name: 'docsify' -}; +} ``` -## nameLink +## name-link - Type: `String` - Default: `window.location.pathname` @@ -248,271 +206,51 @@ The name of the link. ```js window.$docsify = { - nameLink: '/', - - // For each route - nameLink: { - '/zh-cn/': '/zh-cn/', - '/': '/' - } -}; + nameLink: '/' +} ``` ## markdown - Type: `Function` -See [Markdown configuration](markdown.md). +See [Markdown configuration](/markdown). + ```js window.$docsify = { - // object - markdown: { - smartypants: true, - renderer: { - link: function() { - // ... - } - } - }, - - // function - markdown: function(marked, renderer) { + markdown: function (marked, renderer) { // ... - return marked; + return marked } -}; +} ``` -## themeColor +## theme-color - Type: `String` -Customize the theme color. Use [CSS3 variables](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_variables) feature and polyfill in old browser. +Customize the theme color. +Use [CSS3 variables](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_variables) feature and polyfill in old browser. ```js window.$docsify = { themeColor: '#3F51B5' -}; +} ``` ## alias - Type: `Object` -Set the route alias. You can freely manage routing rules. Supports RegExp. + +Set the route alias. You can freely manage routing rules. ```js window.$docsify = { alias: { - '/foo/(+*)': '/bar/$1', // supports regexp '/zh-cn/changelog': '/changelog', - '/changelog': - 'https://raw.githubusercontent.com/docsifyjs/docsify/master/CHANGELOG', - '/.*/_sidebar.md': '/_sidebar.md' // See #301 + '/changelog': 'https://raw.githubusercontent.com/QingWei-Li/docsify/master/CHANGELOG' } -}; +} ``` - -## autoHeader - -- type: `Boolean` - -If `loadSidebar` and `autoHeader` are both enabled, for each link in `_sidebar.md`, prepend a header to the page before converting it to html. Compare [#78](https://github.com/docsifyjs/docsify/issues/78). - -```js -window.$docsify = { - loadSidebar: true, - autoHeader: true -}; -``` - -## executeScript - -- type: `Boolean` - -Execute the script on the page. Only parse the first script tag([demo](themes)). If Vue is present, it is turned on by default. - -```js -window.$docsify = { - executeScript: true -}; -``` - -```markdown -## This is test - - -``` - -Note that if you are running an external script, e.g. an embedded jsfiddle demo, make sure to include the [external-script](plugins.md?id=external-script) plugin. - -## noEmoji - -- type: `Boolean` - -Disabled emoji parse. - -```js -window.$docsify = { - noEmoji: true -}; -``` - -## mergeNavbar - -- type: `Boolean` - -Navbar will be merged with the sidebar on smaller screens. - -```js -window.$docsify = { - mergeNavbar: true -}; -``` - -## formatUpdated - -- type: `String|Function` - -We can display the file update date through **{docsify-updated}** 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; - } -}; -``` - -## externalLinkTarget - -- type: `String` -- default: `_blank` - -Target to open external links. Default `'_blank'` (new window/tab) - -```js -window.$docsify = { - externalLinkTarget: '_self' // default: '_blank' -}; -``` - -## routerMode - -- type: `String` -- default: `hash` - -```js -window.$docsify = { - routerMode: 'history' // default: 'hash' -}; -``` - -## noCompileLinks - -- type: `Array` - -Sometimes we do not want docsify to handle our links. See [#203](https://github.com/docsifyjs/docsify/issues/203) - -```js -window.$docsify = { - noCompileLinks: ['/foo', '/bar/.*'] -}; -``` - -## onlyCover - -- type: `Boolean` - -Only coverpage is loaded when visiting the home page. - -```js -window.$docsify = { - onlyCover: false -}; -``` - -## requestHeaders - -- type: `Object` - -Set the request resource headers. - -```js -window.$docsify = { - requestHeaders: { - 'x-token': 'xxx' - } -}; -``` - -## ext - -- type: `String` - -Request file extension. - -```js -window.$docsify = { - ext: '.md' -}; -``` - -## fallbackLanguages - -- type: `Array` - -List of languages that will fallback to the default language when a page is request and didn't exists for the given local. - -Example: - -- try to fetch the page of `/de/overview`. If this page exists, it'll be displayed -- then try to fetch the default page `/overview` (depending on the default language). If this page exists, it'll be displayed -- then display 404 page. - -```js -window.$docsify = { - fallbackLanguages: ['fr', 'de'] -}; -``` - -## notFoundPage - -- type: `Boolean` | `String` | `Object` - -Load the `_404.md` file: - -```js -window.$docsify = { - notFoundPage: true -}; -``` - -Load the customised path of the 404 page: - -```js -window.$docsify = { - notFoundPage: 'my404.md' -}; -``` - -Load the right 404 page according to the localisation: - -```js -window.$docsify = { - notFoundPage: { - '/': '_404.md', - '/de': 'de/_404.md' - } -}; -``` - -> Note: The options with fallbackLanguages didn't work with the `notFoundPage` options. diff --git a/docs/cover.md b/docs/cover.md index 555f4ff..7054a06 100644 --- a/docs/cover.md +++ b/docs/cover.md @@ -1,99 +1,57 @@ # Cover -Activate the cover feature by setting `coverpage` to **true**, compare [coverpage configuration](configuration.md#coverpage). +Activate the cover feature by setting `coverpage`. The detail in [Configuration#coverpage](zh-cn/configuration#coverpage). ## Basic usage -Set `coverpage` to **true**, and create a `_coverpage.md`: +Set `coverpage` to **true**, and create a `_coverpage.md`. You can see the effect in current website. + + +*index.html* ```html - - - + ``` -```markdown - +*_coverpage.md* +```markdown ![logo](_media/icon.svg) -# docsify 3.5 +# docsify > A magical documentation site generator. -- Simple and lightweight (~21kB gzipped) -- No statically built html files +- Simple and lightweight (~12kb gzipped) - Multiple themes +- Not build static html files -[GitHub](https://github.com/docsifyjs/docsify/) -[Get Started](#docsify) + +[GitHub](https://github.com/QingWei-Li/docsify/) +[Get Started](#quick-start) ``` -!> A document site can have only one coverpage! +!> A document site can have only one cover page. ## Custom background -The background color is generated randomly by default. You can customize the background color or a background image: +The background color is generated randomly by default. You can customize the background color or image. + +*_coverpage.md* ```markdown - +# docsify -# docsify 3.5 - -[GitHub](https://github.com/docsifyjs/docsify/) +[GitHub](https://github.com/QingWei-Li/docsify/) [Get Started](#quick-start) - ![](_media/bg.png) - - ![color](#f0f0f0) ``` - -## Coverpage as homepage - -Normally, the coverpage and the homepage appear at the same time. Of course, you can also separate the coverpage by [onlyCover option](configuration.md#onlycover). - -## Multiple covers - -If your docs site is in more than one language, it may be useful to set multiple covers. - -For example, your docs structure is like this - -```text -. -└── docs - ├── README.md - ├── guide.md - ├── _coverpage.md - └── zh-cn - ├── README.md - └── guide.md - └── _coverpage.md -``` - -Now, you can set - -```js -window.$docsify = { - coverpage: ['/', '/zh-cn/'] -}; -``` - -Or a special file name - -```js -window.$docsify = { - coverpage: { - '/': 'cover.md', - '/zh-cn/': 'cover.md' - } -}; -``` diff --git a/docs/custom-navbar.md b/docs/custom-navbar.md index 324ad81..cc78741 100644 --- a/docs/custom-navbar.md +++ b/docs/custom-navbar.md @@ -1,14 +1,10 @@ # Custom navbar -## HTML +You can create navbar in HTML file. But note that the link begins with `#/`. -If you need custom navigation, you can create a HTML-based navigation bar. - -!> Note that documentation links begin with `#/`. +*index.html* ```html - -