user taylored content delivery (utcd)¶
Gegeben sei eine Menge von Markdown-Dateien. Basierend auf einer manuell gepflegten Inhaltsverzeichnis-Datei _toc.yml
baut das Programm jupyterbook
eine strukturierte Website, wie z.b. der User-Guide https://scikit-learn.org/stable/user_guide.html.
Eine Idee besteht darin, eine komplexe Dokumentation zielgruppenspezifisch zu erzeugen, z.B.
Sprache: DE, EN
Zielgruppe: Einsteiger, Experten, Entwickler
Inhalte: Regression, Klassifikation, etc.
Technisch gesehen geht das leicht, wenn wir die Datei _toc.yml
automatisch erzeugen:
Grundlage dafür sind Metadaten, die unsere Markdown-Dateien in Bezug auf Sprache, Zielgruppe, Inhalte etc. genauer beschreiben.
Es gibt Randbedingungen: Wir brauchen ggf. die Grundlagen für eine Seite, ggf. eine zugehörige Formelsammmlung, jedenfalls ein Glossar
Und vielleicht gibt es interne Informationen, die man mit Passwortschutz versehen will?
Die Herausforderung besteht also darin, basierend auf solchen Metadaten und der Anfrage eines Users eine “Konfiguration” einer zielgruppenspezifischen Dokumentation zu erzeugen, die man dann in Form einer _toc.yml
-Datei ‘rausschreiben kann.
Das Studienprojekt / die Bachelorarbeit / Masterarbeit sucht hier explorativ nach einer Lösung.