Skip to content

_sidebar.md gives 404 #2603

@testsmith-io

Description

@testsmith-io

Description

Maybe it is not a bug..., but I try to use docsify to serve documentation from a github subfolder. But it keeps giving a 404 on _sidebar.md.

-> Locally it work with docsify cli.

The repo structure is at follows:

- repo
-- docs
---getting-started
---quick-start.md
---README.md --> empty
--.nojekyll
--_sidebar.md
--index.html
--README.md
-CNAME
-index.html --> the normal website with a link to /docs...

The content of the file:

_sidebar.md

* [Home](/)
* [Quick Start](getting-started/quick-start.md)

Config in index.html

 window.$docsify = {
      name: 'Perfornium',
      repo: 'https://github.com/testsmith-io/repo',
      routerMode: 'history',
      homepage: 'README.md',

      // Sidebar configuration
      loadSidebar: true,
      autoHeader: true,
      subMaxLevel: 3,

      // Navigation
      loadNavbar: false,

      // Search
      search: {
        maxAge: 86400000,
        paths: 'auto',
        placeholder: 'Search documentation...',
        noData: 'No results found.',
        depth: 3
      },

      // Plugins
      copyCode: {
        buttonText: 'Copy',
        errorText: 'Error',
        successText: 'Copied'
      },

      // Custom theme
      themeColor: '#00d4ff'
    }

Contents of README.md

# perfornium-docs

Hello world!

``hello world``

It keeps giving a 404 on _sidebar.md

XHRGET
https://domain.dev/docs/_sidebar.md
[HTTP/2 404 11ms]

XHRGET
https://domain.dev/_sidebar.md
[HTTP/2 404 9ms]

Expected behavior

Sidebar loads with its content... and no 404 is shown.

Actual behavior

It keeps giving a 404 on _sidebar.md

XHRGET
https://domain.dev/docs/_sidebar.md
[HTTP/2 404 11ms]

XHRGET
https://domain.dev/_sidebar.md
[HTTP/2 404 9ms]

Steps to reproduce

see above

Environment

I serve the website using GitHub Pages.

Additional Information

  • Bug still occurs when all/other plugins are disabled?

Metadata

Metadata

Assignees

No one assigned

    Labels

    questionwait for informationsomething is not clear, waiting for the author of the issue/pr

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions