docsifyjs / docsifyjs/docsify

support the the `":include"` helper, or similar, for _sidebar and _navbar.

Offen
#1,978 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
enhancement needs discussion
Vorherrschende Sprache
JavaScript
Sterne
31.5k
Forks
5.8k
Ø Merge
9 T. 8 Std.
Gemergte PRs (30 T.)
2

Beschreibung

## Feature request

#### What problem does this feature solve?

To include an external page, one must create a new markdown file with the `[include](//foo.com/foo ':include')` inside of it, then they can link to the local file from the sidebar. That's a lot of work.

#### What does the proposed API look like?

An update would allow us to include directly from sidebar or navbar, like so:

```markdown

- Menu:
- [Page from outside](https://outside.com/foo.md ":include")
```

This would cause the sidebar link to load the content from the outside location, and we don't need to make a wrapper file.

#### How should this be implemented in your opinion?

Need to update the sidebar and navbar compilers to support features like main compiler. The code is already duplicated twice between client renderer and server renderer, and we don't want more duplicates, so we would need to consolidate code and re-use it well.

#### Are you willing to work on this yourself?

Beitragsleitfaden

Beitragsleitfaden öffnen

Bewertung

Dieses Issue wurde noch nicht bewertet.

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.