Veröffentlichte Seiten für Dokumentation?

Ich bin mir bei diesen veröffentlichten Seiten nicht mehr sicher.
Kontext: Ich habe eine Menge Dokumentation, die in Google Docs liegt. Im Zuge des Umzugs unserer Community von Facebook zu Discourse nutzen wir die Gelegenheit, die Dokumentation ebenfalls zu Discourse zu migrieren.

Die Leute mochten es, dass die Dokumentation öffentlich und „Word-ähnlich“ war; sie druckten die Dateien zum Nachschlagen aus, brachten Kopien zu ihrem Tierarzt mit oder schickten Links per E-Mail.

Für mich liegt der Hauptvorteil der Seitenveröffentlichungsfunktion darin, dass sie es uns ermöglicht, etwas zu veröffentlichen, das sonst privat geblieben wäre. Aber wenn die Dokumentation, wie in meinem Fall, bereits in einer Kategorie ist, die öffentlich sein wird, macht es dann überhaupt Sinn, sie zusätzlich zu veröffentlichen?

Die URLs sind etwas schöner. Es gibt weniger „Discourse-Möblierung“ auf der Seite, was nett ist (aber andererseits erfordert, dass ein Footer oder etwas Ähnliches hinzugefügt wird, um anzuzeigen, dass es sich um ein Community-Dokument handelt … keine große Sache).

Aber wo ich wirklich ein Problem sehe, sind die vielen Links innerhalb der Dokumente, die auf andere Dokumente verweisen (juchhu Hypertext). Wenn ich die URLs der „veröffentlichten Seite“ verwende, werden Community-Mitglieder, die die Dokumentation lesen, auf eine Weise aus der Community herausgeführt und finden möglicherweise nicht mehr zurück. Wenn wir die URLs des „Discourse-Themas“ verwenden, landen externe Leser auf Discourse-Seiten, komplett mit Antworten und (zumindest in meinem Fall, vielleicht kann ich das ändern?) einer langen Liste neuer ungelesener Themen, die sie durchstöbern können.

Hier ist ein Beispiel:

Wer stand vor einem ähnlichen Dilemma? Wie haben Sie es gelöst? Gibt es hier Funktionen, die mir helfen könnten, die ich aber vielleicht noch nicht kenne?

Ich danke Ihnen im Voraus für Ihre Einsichten.

3 „Gefällt mir“

Ich habe keine Antworten; aber die Seitenveröffentlichungsfunktion, obwohl sie das tut, wofür sie gebaut wurde, ist zutiefst funktionsarm. Ich bin nicht überzeugt, dass dies der richtige Weg für Ihren Zweck ist :thinking:

3 „Gefällt mir“

In der Tat! Sie haben gerade den Hauptanwendungsfall der Seitenveröffentlichung (private Inhalte öffentlich machen) – und ihre Haupteinschränkung (Link-Verwirrung und fehlende Navigation) – erläutert. Verwenden Sie einfach Ihre öffentliche Kategorie und gestalten Sie diese bei Bedarf etwas um. Möglicherweise finden Sie Discourse Doc Categories für die Navigation nützlich.

3 „Gefällt mir“

Ich bin immer noch etwas unentschlossen. Ich denke, dass es für bestimmte Dokumente besser wäre (wenn die Person nicht mit Discourse verbunden ist), wenn die Seitenleiste und ungelesene Themen und andere Dinge fehlen würden. So sieht es eher wie ein „Dokument“ aus. Gäbe es eine Möglichkeit, es Nicht-Discourse-Benutzern so anzuzeigen, aber eingeloggten Benutzern „mit Discourse-Möbeln“ anzuzeigen? Mit derselben URL?

Gäbe es Lösungen, die man mit WordPress erkunden könnte (ich habe noch überhaupt nicht untersucht, wie sie zusammenspielen), aber könnte eine WordPress-Seite als Thema in Discourse „gespiegelt“ werden, zum Beispiel?

2 „Gefällt mir“

Auf jeden Fall. Schauen Sie sich WP Discourse – WordPress plugin | WordPress.org an. Es ist nicht offiziell, aber es gibt eine Kategorie dafür: Support > WordPress

Sie können es live hier sehen: https://monocycle.info, Artikel werden automatisch im Forum veröffentlicht: Actualités - Monocycle.info

1 „Gefällt mir“

Zur Info, ich habe dies in ein neues Thema verschoben – ich denke, es ist wertvoll.

Mir entgeht wohl eine Nuance – warum kann man private Themen nicht einfach öffentlich machen, anstatt die Seitenveröffentlichung zu nutzen? Man könnte Permalinks verwenden, wenn die URL so wichtig ist. Sehen Sie, wie https://meta.discourse.org/fun zu https://meta.discourse.org/t/discourse-stickers/390126 weiterleitet.

3 „Gefällt mir“

Keine dieser URLs ist für mich erreichbar. Ist das beabsichtigt?

2 „Gefällt mir“

Heh, das war dumm von mir. Sie sind in einer privaten Kategorie. Ich werde ein besseres Beispiel finden. (Bearbeitet.)

2 „Gefällt mir“

Danke, dass du das aufgegriffen hast! Das könnte spezifisch für das Thema meiner Community sein. Zusätzlich zu den Informationen, die sie bereitstellen, haben wir festgestellt, dass die Tatsache, dass unsere Dokumente wie „echte Dokumente“ und nicht wie „Webseiten“ aussehen, uns hilft, ernst genommen zu werden. Unsere Mitglieder können einen Ausdruck eines Dokuments, das wie „ein seriöser Artikel“ aussieht, ihren Tierärzten zeigen –– diese „sekundäre Zielgruppe“ von uns (die tatsächlich sehr wichtig ist, auch wenn sie keine sehr aktiven Teilnehmer unserer Community selbst sind) hat wahrscheinlich, wie die meisten Angehörigen der medizinischen Berufe, starke negative Vorurteile gegenüber „Zeug aus dem Internet“.

Meine Sorge ist also, dass die Art und Weise, wie unsere Dokumentation aussieht – nämlich „etwas aus einem Internetforum (omg)“ – die Wahrnehmung bei Mitgliedern außerhalb unserer Community verändern wird.

Siehst du das Problem?

Oh, danke, das wusste ich nicht/hatte ich vergessen, dass das eine Option ist! Das werde ich definitiv nutzen.

Ich denke, einige Ideen, die mir aus meinem aktuellen Dokumentationsdilemma helfen könnten, wären:

  • ein themenspezifisches Layout für Dokumente innerhalb des Themes zu haben (oder allgemeiner, ein anderes Aussehen/Layout für eine bestimmte Kategorie wählen zu können)
  • in einigen Kategorien Dingen für nicht eingeloggte Besucher anders anzeigen zu können (oder sogar nach TL?)
  • „Discourse-Möbel“ zu veröffentlichten Seiten hinzufügen zu können, wenn sie von einem eingeloggten Benutzer angesehen werden (aber natürlich beim Drucken entfernt werden)

Nur ein paar neblige Morgenideen!

1 „Gefällt mir“

Hier sind ein paar Variationen einer einfachen Möglichkeit, dies ohne Discourse „Möbel“ zu beheben: Fügen Sie einen Link zu Ihrer Dokumentations-Indexseite direkt in das Thema ein. (Benutzer sind möglicherweise nicht immer von der Indexseite gekommen – aber zumindest gelangen sie dorthin zurück, wo sie navigieren können.)

Einen Index-Link hinzufügen

Wenn Sie immer auf die veröffentlichten Seiten verlinken (die für den Druck viel schöner aussehen), dann ist es vielleicht so einfach – beginnen Sie einfach den Inhalt jedes einzelnen Themas mit einem Link zurück zu Ihrer Indexseite:

[Toute la documentation DF](https://entraide.diabete-felin.com/t/toute-la-documentation-df)

Que tu te sentes prêt·e à te lancer...

oder

Einen Index-Link hinzufügen, der intern verborgen ist

Wenn Sie manchmal auf die veröffentlichten Seiten verlinken, aber manchmal auch auf die tatsächlichen Themen, möchten Sie den Index-Link möglicherweise intern ausblenden:

Fügen Sie ein [wrap] um einen Link zu Ihrer FAQ/Dokumentations-Indexseite hinzu:

[wrap=index-link]
[Toute la documentation DF](https://entraide.diabete-felin.com/t/toute-la-documentation-df)
[/wrap]

Que tu te sentes prêt·e à te lancer...

Der [wrap]-Code ermöglicht dieses bisschen benutzerdefiniertes CSS, um diesen Link auszublenden, wenn das reguläre Thema selbst angezeigt wird:

article [data-wrap="index-link"] {
  display: none;
}

Aber der Link wird auf der veröffentlichten Seite immer noch angezeigt, sodass Leser einfach zum Forum zurückkehren können.

Danke, das sieht hilfreich aus! Wir werden uns in unseren Diskussionen sicherlich auf die Themenseiten verlinken, da der ganze Sinn und Zweck, sie in Discourse zu haben, darin besteht, es den Leuten leicht zu machen, darauf zu verweisen.

Hallo, ich habe das gerade versucht, aber das sind wirklich Weiterleitungen und keine Permalinks, oder? Oder gibt es eine Möglichkeit, den „permanenten Link“ zu dem zu machen, der angezeigt wird, wenn das Ziel geladen wird?

Ein weiteres Problem, das ich habe, ist, dass die Druckversion für die veröffentlichte Seite nicht besonders gut ist (aber ich muss noch an den Bildschirmstilen arbeiten). Ist dies ein Theme-Problem? Wenn ich die Druck-CSS verbessern möchte, wo kann ich das tun?

1 „Gefällt mir“

Ja, das sind Weiterleitungen (warum wurden sie nicht von Anfang an so benannt? :thinking:), und nein, es ist nicht möglich, dieselbe URL beizubehalten. Vielleicht mit einem benutzerdefinierten Plugin…

1 „Gefällt mir“

Die Druckansicht lädt discourse/app/assets/stylesheets/common/base/crawler_layout.scss at main · discourse/discourse · GitHub. Ich bin mir nicht sicher, ob es andere druckspezifische CSS gibt.

Sie können mit der Body-Klasse crawler zielen. Oder schlagen Sie Änderungen in Contribute > Feature vor, wenn Sie denken, dass dies der gesamten Community zugutekommen könnte :slight_smile:

Bearbeitung: Es gibt discourse/app/assets/stylesheets/common/printer-friendly.scss at main · discourse/discourse · GitHub

Soweit ich das verstehe, wird crawler_layout.scss speziell auf das Layout des Crawlers angewendet. Seiten ohne Crawler-Layout laden immer noch printer-friendly.scss, wenn wir das Druckfenster öffnen.

Für Anpassungen verwenden Sie die @media print { Media Query.
Bitte korrigieren Sie mich, wenn ich falsch liege.

1 „Gefällt mir“