- Replace live-server with existing Browsersync dependency as web server
- Remove duplicate `index.html` file
- Add `build:html` script to generate `/docs/preview.html`
BREAKING: The new project layout might break in some tooling setups.
We've added an exports field to `package.json` to specify where
statements like `import ... from 'docsify'` will import from, and left
the `main` and `unpkg` fields as-is for backwards compatibility with the
global <script> import method. Most people who use a non-module
`<script>` tag to import Docsify will not notice a difference. Anyone
else who is importing Docsify into a specilized build setup using
`import` statements has a chance of being broken, so we've marked this
as BREAKING.
* Update test environments and lint configuration
Update Jest (unit + integration) and Playwright (e2e) test environments. Includes stability improvements for e2e tests using newer, more stable methods per the Playwright docs.
- Update Jest 26 => 27
- Update Jest-related libs (babel parser)
- Update Playwright 1.8 => Playwright Test 1.18
- Update GitHub CI (action versions, job parallelization, and matrices)
- Update ESLint 5 => 8
- Update ESLint-related libs (parser, prettier, Jest, Playwright)
- Fix test failures on M1-based Macs
- Fix e2e stability issues by replacing PW $ method calls
- Fix ESLint errors
- Fix incorrect CI flag on Jest runs (-ci => --ci)
- Refactor e2e test runner from Jest to Playwright Test
- Refactor e2e test files for Playwright Test
- Refactor fix-lint script name to lint:fix for consistency
- Refactor npm scripts order for readability
- Remove unnecessary configs and libs
- Remove example image snapshots
* Fix: Cannot serve off `/.../index.html`
Docsify must be hosted on a server that supports a default directory
index (i.e. maps `/.../` -> `/.../index.html`).
Some platforms do not support this, however. For example, HTML apps
hosted on the popular game/software platform, Itch.io.
This change supports hosting Docsify off an explicit path file, such as
`/index.html`. It does this by:
1. Adding handling for paths like `index.html#/blah`, and
2. Normalising paths with fragments back to markdown paths
For example, `http://example.org/index.html#/blah` would be mapped to
`http://example.org/blah.md`.
This fixes:
https://github.com/docsifyjs/docsify/issues/427
* Add end-to-end test for index file hosting
* Add code comments for explicit file changes
* Add additional tests for index file hosting
* Add additional tests for index file hosting
* [wip] Attempt to switch tests to Jest
* Add e2e test for new Jest test framework
* Verify sidebar links use file hosting
* Fix: endsWith() not supported for IE11
* Refactor: utility method moved to utility file
* Fix IE11 error from use of String.includes()
Co-authored-by: John Hildenbiddle <jhildenbiddle@users.noreply.github.com>
