Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

Load markdown from external sources

Offen
#229 1 Kommentar 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Anfängerfreundlichkeit
25/100
Issue-Typ
Feature
Klarheit
Muss geklärt werden
Aktivitätsstatus
Veraltet
Tech-Stack
javascript, nodejs
Bereich
cli, documentation

Rechercherichtung

Beginne damit zu prüfen, wie docsify-cli derzeit Verzeichnisse durchsucht und Markdown-Links sowie URL-Pfade erstellt. Definiere das Verhalten der externen README.md- und baseUrl-Zuordnungen, einschließlich lokaler Überschreibungen für Entwicklung und Tests. Als erledigt gilt die Aufgabe, wenn konfigurierte externe Repositories in der Navigation der veröffentlichten Dokumentation erscheinen können und lokale Zuordnungen wie vorgesehen funktionieren.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

I plan on using docsify for repo docs. One of the requirements I have is to have one repo link out to each repo's docs index file (README.md). This main repo will be the org-wide repo with a table of contents of all other documentation as well as organization/high-level documentation. The goal is to publish this org-wide docs repo and have it be the primary knowledge source for the organization which would include each repo's documentation on that website.

In order to do this, it would make sense if I can link to other external README.md files by URL. Right now docsify reads the directory to create table of contents and URL paths. Could it also grep (using ripgrep for fast file search) for all markdown links and source paths/pages from external? One could configure a baseUrl map so it only looks for links including a baseUrl in the map. The baseUrl table could allow for developers to map baseUrls to some overrides for local development and testing with the locally cloned repos.

Vorherrschende Sprache
JavaScript
Sterne
781
Forks
166
Ø Merge
10 Std. 49 Min.
Gemergte PRs (30 T.)
1

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus docsifyjs/docsify-cli

Alle Issues in docsifyjs/docsify-cli

Ähnliche Issues

Weitere Issues zu JavaScript

Neue Issues direkt in Ihr Postfach

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