Wissensdatenbank

:warning: Die Funktionalität dieses Theme-Komponenten wurde durch das Plugin Discourse Docs ersetzt

Diese Theme-Komponente ermöglicht eine Wissensdatenbank-ähnliche Ansicht für ausgewählte Kategorien.

:link: Link zum Repository

:link: Vorschau im Theme-Creator


Für alle in den Einstellungen aktivierten Kategorien wird eine KB-Schaltfläche zu den Navigations-Pills hinzugefügt.

Sobald die Ansicht umgeschaltet ist, zeigt die Wissensdatenbank eine reduzierte Version der neuesten Themenliste an.

Klicken Sie auf ein Tag in der Seitenleiste, und die Themenliste wird automatisch nach diesem Tag gefiltert. Sie können beliebig viele Tags auswählen, und die Tag-Liste zeigt nur die Tags an, die zu den gefilterten Themen hinzugefügt wurden, um die Durchsuchung umfangreicher Dokumentation zu erleichtern.

Möchten Sie suchen? Geben Sie einfach einen Begriff in das Feld ein. Die Suchergebnisse beschränken sich ebenfalls auf die von Ihnen ausgewählten Tags.

Zu berücksichtigende Punkte

Die folgenden Site-Einstellungen sind für die Funktionsfähigkeit dieser Komponente erforderlich: Tagging aktiviert und Filter nach Tag anzeigen.

Diese Theme-Komponente verfügt derzeit noch über keine mobile Ansicht.

Trotzdem arbeiten wir an einer weiterentwickelten Version davon. Sobald diese fertig ist, werden wir Sie hier auf Meta informieren!

27 „Gefällt mir“

Dieser Commit fügt nun eine grundlegende mobile Ansicht hinzu.

Beachte, dass sie nicht perfekt ist, da du bei vielen Tags über sie hinweg scrollen musst. Ich habe ein paar Ideen, wie ich das beheben könnte.

9 „Gefällt mir“

Wir nutzen Discourse seit über 4 Jahren als unsere Wissensdatenbank und haben rund 350 spezifische Beiträge zur Wissensdatenbank. Das ist also sehr aufregend!

Ich bin mir nicht sicher, ob dies über eine Theme-Komponente möglich ist, aber gibt es eine Möglichkeit, dass diese “Ansicht” standardmäßig geladen wird, wenn jemand eine Kategorie öffnet? Also statt zu: /c/knowledge-base zu gehen, würde sie automatisch als /c/knowledge-base?kb=active geladen werden?

Wir haben die KB-Theme-Komponente aktiviert und sind sehr zufrieden damit, aber wir befürchten, dass die Leute die KB-Ansicht nicht sehen, weil sie den zuvor gespeicherten Link /c/knowledge-base verwenden.

Vielen Dank für Ihre Arbeit daran.

6 „Gefällt mir“

Ich werde prüfen, ob wir eine Einstellung dafür hinzufügen können! Danke für den Vorschlag und schön, dass du das nützlich findest!

6 „Gefällt mir“

Dies ist jetzt als Theme-Einstellung implementiert. Unterthemen werden ebenfalls unterstützt!

9 „Gefällt mir“

Gerade aktualisiert. Sieht toll aus, danke!

3 „Gefällt mir“

Wie wendet man das auf eine Unterkategorie an? Gibt es eine spezielle Syntax?

Vielen Dank dafür! Wir haben in unserer Community eine Kategorie, die sich perfekt für die Anwendung dieser Komponente eignen würde, aber wir stoßen auf ein Problem: Kategorien werden nicht im Dropdown-Menü „kb categories

Sie können einfach den Kategorie-Slug eingeben und diese erstellen. Es ist nicht besonders intuitiv. Ich habe nicht herausfinden können, wie man Unterkategorien erstellt, aber wenn Ihre Kategorie auf der ersten Ebene liegt, ist es ziemlich einfach.

1 „Gefällt mir“

Ok, wirklich nicht intuitiv. Ich habe die Kategorie eingegeben und „erstellt“, und es hat funktioniert. Aber sie erscheint immer noch nicht wie erwartet.

Ich habe eine frische Discourse-Installation zum Testen durchgeführt und beide Komponenten eingerichtet:

br%20a170a9ec422c

(D.I.Y. / diy ist die Kategorie, für die ich die Wissensdatenbank aktivieren möchte, und sie hat einen spezifischen Top-Link, der mit der Komponente Benutzerdefinierte Top-Navigationslinks erstellt wurde)

br%2086f9546a1534

Aber die Kategorie D.I.Y. wird mit der normalen Ansicht angezeigt:

Die URL endet mit: /c/diy?kb=active

1 „Gefällt mir“

Keine spezielle Syntax – geben Sie einfach den Slug der Kategorie (egal ob Hauptkategorie oder Unterkategorie) in die Theme-Einstellung kb categories ein, aktualisieren Sie Ihren Browser, und es sollte funktionieren.

Das ist derzeit eine Einschränkung der Theme-Einstellungen – Sie müssen den Slug wie von @Sean_R vorgeschlagen manuell eingeben.

Haben Sie das Problem @TowerBR bereits gelöst? Haben Sie nach dem Hinzufügen der Kategorie zur Einstellung den Browser aktualisiert? Haben Sie auf die KB -Taste geklickt? Entschuldigen Sie die einfachen Fragen, aber ich versuche, der Sache auf den Grund zu gehen.

1 „Gefällt mir“

Es hat funktioniert, danke :slight_smile:

Mir gefällt diese Lösung, da ich alle meine KB-Unterkategorien gleich benennen und sie nur einmal hinzufügen muss.

Mir ist jedoch aufgefallen, dass, wenn ich über das Dropdown-Menü zur Kategorie navigiere, nicht automatisch auf die KB-Ansicht umgeschaltet wird.

Alle anderen Navigationsmethoden scheinen zu funktionieren, aber das Dropdown-Menü für die Unterkategorie nicht.

2 „Gefällt mir“

Ist die Option standardmäßig KB-Ansicht aktiviert? Ich habe das gerade auf einer meiner Seiten getestet, und es funktionierte mit Unterkategorien.

2 „Gefällt mir“

Das tue ich, und es funktioniert meistens, nur nicht, wenn ich das Dropdown-Menü für Unterkategorien verwende, um von einer Kategorie zu einer anderen zu wechseln.

Seltsam – okay. Wenn du es konsistent reproduzieren kannst, lass es mich wissen, dann schaue ich mir das an. Ich konnte dieses Verhalten mit dem Dropdown-Menü für Unterkategorien nicht auslösen.

2 „Gefällt mir“

Ja, das habe ich bereits getan. Siehe das Bild im vorherigen Beitrag:

br%2086f9546a1534

Ich habe die Komponente „Benutzerdefinierte Top-Navigationslinks

Nutzt du die neueste Version der Theme-Komponente? Läuft deine Discourse-Version auf tests-passed oder stable?

2 „Gefällt mir“

Das passiert jedes Mal. Ich kann einfach auf „KB

Ja:

params:
   version: tests-passed
3 „Gefällt mir“

Das ist großartig! Ich habe es gerade installiert, um einen Blick darauf zu werfen, und ich kann bereits sehen, dass es sehr nützlich ist.

Diese Theme-Komponente scheint tatsächlich mit https://meta.discourse.org/t/knowledge-base-plugin/115288 von @angus zu kollidieren. Ich kann bestätigen, dass das Plugin deinstalliert werden muss, bevor diese Theme-Komponente aktiviert wird; andernfalls passiert Folgendes, wenn man sich eine Knowledge-Base-Kategorie ansieht. Beachten Sie die seltsame horizontale Linie neben dem Menü und den drehenden Kreis.

Ich würde gerne mehr über die fortgeschrittene Version und Ihre Pläne hören. Ein paar Rückmeldungen:

  • Fehler? Wenn Sie ein Tag im linken Menü auswählen, um danach zu filtern, und dann zu einer anderen Kategorie oder „Neueste“ usw. wechseln, werden Sie beim nächsten Klick auf KB zur Rückkehr zur Knowledge Base feststellen, dass Sie immer noch nach diesem Tag gefiltert sind.
  • Wenn Sie auf das Tag unter einer Überschrift klicken, gelangen Sie zur Tag-Seite für dieses Tag, nicht zu einer gefilterten KB-Ansicht, wie es beim Klick auf das Tag im linken Menü der Fall ist.
  • Klicken Sie auf den Titel der Tag-Kategorie im linken Menü, und Sie werden zur „Neueste“-Ansicht der Kategorie weitergeleitet. Ich schlage vor, dass dies nirgendwohin verlinkt. Der Kategoriename sollte wahrscheinlich auch kein # enthalten, was ablenkt.
  • Es wäre praktisch, die Anzahl der Themen mit jedem Tag im linken Menü zu sehen.
  • Es wäre hilfreich, KB-Themen alphabetisch oder sogar in einer benutzerdefinierten Reihenfolge sortieren zu können.
4 „Gefällt mir“