fix: Cannot serve off /.../index.html

src/core/router/history/hash.js

@@ -18,7 +18,15 @@ export class HashHistory extends History {
     const path = window.location.pathname || '';
     const base = this.config.basePath;
 
-    return /^(\/|https?:)/g.test(base) ? base : cleanPath(path + '/' + base);
+    // This handles the case where Docsify is served off an
+    // explicit file path, i.e.`/base/index.html#/blah`. This
+    // prevents the `/index.html` part of the URI from being
+    // remove during routing.
+    // See here: https://github.com/docsifyjs/docsify/pull/1372
+    const basePath = path.endsWith('.html')
+      ? path + '#/' + base
+      : path + '/' + base;
+    return /^(\/|https?:)/g.test(base) ? base : cleanPath(basePath);
   }
 
   getCurrentPath() {

src/core/router/util.js

@@ -76,8 +76,38 @@ export const resolvePath = cached(path => {
   return '/' + resolved.join('/');
 });
 
+/**
+ * Normalises the URI path to handle the case where Docsify is
+ * hosted off explicit files, i.e. /index.html. This function
+ * eliminates any path segments that contain `#` fragments.
+ *
+ * This is used to map browser URIs to markdown file sources.
+ *
+ * For example:
+ *
+ * http://example.org/base/index.html#/blah
+ *
+ * would be mapped to:
+ *
+ * http://example.org/base/blah.md.
+ *
+ * See here for more information:
+ *
+ * https://github.com/docsifyjs/docsify/pull/1372
+ *
+ * @param {string} path The URI path to normalise
+ * @return {string} { path, query }
+ */
+
+function normaliseFragment(path) {
+  return path
+    .split('/')
+    .filter(p => !p.includes('#'))
+    .join('/');
+}
+
 export function getPath(...args) {
-  return cleanPath(args.join('/'));
+  return cleanPath(args.map(normaliseFragment).join('/'));
 }
 
 export const replaceSlug = cached(path => {

test/e2e/index-file.test.js

@@ -0,0 +1,28 @@
+const docsifyInit = require('../helpers/docsify-init');
+
+describe(`Index file hosting`, function() {
+  const sharedOptions = {
+    config: {
+      basePath: `${TEST_HOST}/docs/index.html#/`,
+    },
+    testURL: `${TEST_HOST}/docs/index.html#/`,
+  };
+
+  test('should serve from index file', async () => {
+    await docsifyInit(sharedOptions);
+
+    await expect(page).toHaveText(
+      '#main',
+      'A magical documentation site generator'
+    );
+    expect(page.url()).toMatch(/index\.html#\/$/);
+  });
+
+  test('should use index file links in sidebar from index file hosting', async () => {
+    await docsifyInit(sharedOptions);
+
+    await page.click('a[href="#/quickstart"]');
+    await expect(page).toHaveText('#main', 'Quick start');
+    expect(page.url()).toMatch(/index\.html#\/quickstart$/);
+  });
+});