Platzhalterformulare

[Discourse]

	Zusammenfassung	Platzhalter-Formulare ermöglichen es Ihnen, dynamische Dokumentation zu erstellen, indem Sie ein Formular erstellen, das jedes Vorkommen von =MUSTER= in Ihrem Beitrag durch den Wert aus einem Text- oder Auswahlfeld ersetzt.
	Vorschau	Vorschau im Discourse Theme Creator
	Repository-Link	https://github.com/discourse/discourse-placeholder-theme-component
	Neu bei Discourse-Themes?	Einsteigeranleitung zur Verwendung von Discourse-Themes

Installieren Sie diese Theme-Komponente

Da dies eine official theme component ist, die vom Discourse-Team gepflegt wird, können Support, Contribute > Bug, Contribute > UX und #contribute:feature-Anfragen in den jeweiligen Kategorien hier auf Meta gestellt und mit dem entsprechenden Tag für die Theme-Komponente versehen werden. Klicken Sie auf einen der unten stehenden Links, um eine Anfrage zu starten.

 Support  Bug  UX  Feature

Funktionen

Fügen Sie Platzhalter in Beiträgen in diesem Format hinzu:

[wrap=placeholder key=NAME description="Ihr Name"][/wrap]
[wrap=placeholder key=COUNTRY default=US defaults=FR,DE,US,CN,AU,CA][/wrap]

Ihre E-Mail: =NAME=-=COUNTRY=@example.com

Und dies führt zu:

Dies wird in der Mailingliste verwendet

Ihre E-Mail: =ZNAME=-=ZCOUNTRY=@example.com

Wie oben gesehen, wird der Text innerhalb des Wrappers als lange Beschreibung verwendet.

[wrap=placeholder key=NAME description="Ihr Name"]
Dies wird in der Mailingliste verwendet
[/wrap]

Verfügbare Schlüssel

• key: Der Schlüssel, der in Ihrem Beitrag ersetzt werden soll
• default/defaults: Standardwert(e)
• description: Ein Platzhaltertext für die Eingabe

Beispiele

# erstellen Sie ein neues Plugin
rails g plugin =PLUGIN_NAME=
cd plugins/=PLUGIN_NAME=

Dateien- und Bild-Uploads zu S3 einrichten

So, you want to use S3 to handle image uploads? Here’s the definitive guide, but also see Configure an S3 compatible object storage provider for uploads to see how to configure your app.yml. S3 registration Head over to https://aws.amazon.com/free/ and click on [Create a Free Account] During the create account process, make sure you provide payment information, otherwise you won’t be able to use S3. There’s no registration fee, you will only be charged for what you use, if you exceed the AWS …

---

Wir verwenden es, um Runbooks, Anleitungen und wiederverwendbare Vorlagen zu erstellen (es funktioniert auch in Code-Blöcken). Teilen Sie uns bitte Ihre Anwendungsfälle mit!

Einstellungen

Übersetzung	Standard
toolbar.builder	Platzhalter hinzufügen
builder.errors.no_key	Ein Schlüssel ist erforderlich.
builder.title	Platzhalter hinzufügen
builder.insert	Einfügen
builder.key.label	Schlüssel
builder.key.description	Der =Schlüssel=, der im Beitrag ersetzt wird.
builder.description.label	Beschreibung
builder.description.description	Beschreibung, die bei der Eingabe angezeigt wird, wenn kein Wert festgelegt ist.
builder.values.label	Standardwert(e)
builder.values.description	Optionale Wert(e) für Ihren Platzhalter. Wenn mehrere Werte definiert sind, wird eine Auswahlliste verwendet.

Von uns gehostet? Theme-Komponenten sind auf unseren Standard-, Business- und Enterprise-Plänen verfügbar.

[j.jaffeux (Joffrey Jaffeux)]

Das große Problem bei der mathematischen Verarbeitung auf diese Weise ist, dass du eval() verwenden musst, und eval ist unsicher. Daher musst du eine Bibliothek verwenden, die eine sichere eval-Funktion mit einer eingeschränkten Teilmenge der echten eval-Funktion bietet. Ich bin mir nicht sicher, ob wir all diese Komplexität für einen so seltenen Fall wollen.

[Benjamin_D (Benjamin Decotte)]

[quote=“joffreyjaffeux, Beitrag:1, Thema:113533”]
Versuche doch mal, dies mit dem Theme-Komponente „Reply Template

[j.jaffeux (Joffrey Jaffeux)]

Ja, ich bin mir nicht sicher, was ich mir damals gedacht habe, als ich das geschrieben habe… Ich hatte wahrscheinlich einen anderen Anwendungsfall im Sinn, kann mich aber nicht mehr erinnern.

Es kann auf diese Weise definitiv nicht funktionieren. Ich werde mir noch etwas Gedanken dazu machen… Beide Theme-Komponenten waren damals Experimente und könnten eine bessere Behandlung verdienen, da sie von den Nutzern recht häufig verwendet werden.

[Benjamin_D (Benjamin Decotte)]

@j.jaffeux

Ich werde mir das noch einmal überlegen…

Danke!

[Benjamin_D (Benjamin Decotte)]

Ich weiß nicht, was in der Chef-Küche so vor sich geht, aber da ich mich beim Warten normalerweise mit Pistazien oder ähnlichem vollstopfe, habe ich es geschafft, es zum Laufen zu bringen (natürlich für meinen speziellen Anwendungsfall, denn ich habe fast keine Ahnung, was ich tue, aber hey… )

Add 2 replacers

[j.jaffeux (Joffrey Jaffeux)]

Idealerweise würde ich gerne Admins ermöglichen, eigene Ersetzer zu definieren. Da eval jedoch riskant ist (und bei einer sicheren CSP gar nicht möglich), bin ich mir nicht sicher, wie ich das umsetzen könnte…

[sewid (Sebastian)]

Zunächst einmal: Eine großartige und wirklich hilfreiche Theme-Komponente.

Aber ich glaube, ich habe einen Fehler gefunden. Wenn ich in einem Code-Snippet einen Platzhalter verwende, der Backticks (`) enthält, funktioniert es nicht. Ein Beispiel ist ein SQL-Code-Snippet:

DELETE FROM `=TABLENAME=`
WHERE id NOT IN(
        SELECT
            id FROM (
                SELECT
                    id FROM `=TABLENAME=`
                ORDER BY
                    id DESC
                LIMIT 20
) subquery);

TABLENAME wird nie ersetzt (falls ein TABLENAME-Platzhalter vorhanden ist).

[AquaL1te]

Es wäre cool, wenn dies auch Jinja2-ähnliche Bedingungen beinhalten würde. So dass z.B. jemand einen Schlüssel red erstellen und diesen auf das Icon abbilden könnte, orange würde auf abgebildet werden. Aber ich kann natürlich auch ohne leben, aber es wäre cool gewesen, diese Testbedingungen zu haben.

[maiki]

Ich liebe diese Komponente wirklich.

---

„Und du lebst wirklich von dem =NOUN_1=? Was für ein =ADJECTIVE_1= Leben!“

„Davon und damit und darauf und darin“, sagte =PERSON_1=. „Es ist mein Bruder und meine Schwester, und Tanten, und =NOUN_2=, und Essen und Trinken, und (=ADJECTIVE_2=) =VERBING_1=. Es ist mein =NOUN_3=, und ich will kein anderes. Was es nicht hat, ist nicht wert, =VERBING_2= zu werden, und was es nicht weiß, ist nicht wert, =VERBING_3= zu werden. Herr! die =NOUNS_1= die wir zusammen hatten! Ob im Winter oder Sommer, Frühling oder Herbst, es hat immer seinen =NOUN_4= und seine =NOUNS_2=. Wenn im Februar die =NOUNS_3= sind und mein =NOUN_4= und Keller voller =NOUN_5= sind, die mir nichts nützen, und der =COLOR_1= =NOUN_6= an meinem besten =NOUN_7= Fenster vorbeiläuft; oder wieder, wenn alles =ADVERB_1= fällt und Stellen von =NOUN_8= zeigt, die nach =FOOD_1= riechen, und die =NOUNS_5= und =NOUNS_6= die Kanäle verstopfen, und ich kann über =MOISTURE= =NOUN_9= über den größten Teil des =NOUN_10= davon =VERB_1= und frisches =FOOD_2= zum Essen finden, und Dinge, die =ADJECTIVE_3= Leute aus =NOUNS_7= fallen gelassen haben!“

---

Original entnommen aus der Standard Ebooks Version von The Wind in the Willows, online lesbar (suchen Sie nach By it and with it).

[Don]

Hallo

Vielen Dank für diese Komponente Sie passt perfekt zu dem, was ich gerade erreichen möchte. Tatsächlich war mein erster Gedanke, dass es super wäre, wenn sie mit der Reply Template Komponente kombiniert werden könnte. Aber leider ist das nicht möglich, wie die obigen Beiträge erklärt haben.

---

Ich habe einen Workaround gefunden, um sie als Vorlage zu verwenden. Sie funktioniert mit Link zu neuen Themen und Link zu neuen persönlichen Nachrichten.

So habe ich es gemacht:

1. Erstellen Sie ein Platzhalterformular (um es einfach zu halten, verwende ich das Beispiel im OP)

Ihre E-Mail: =NAME=-=COUNTRY=@example.com

---

2. Erstellen Sie einen Link zu einem neuen Thema:
   Ich habe im Link Folgendes eingestellt:
3. Kategorie
4. Titel
5. Text

Wenn Sie Leerzeilen hinzufügen möchten, verwenden Sie \\, damit der Link nicht unterbrochen wird, oder um ihn unsichtbar zu machen, können Sie \u0026nbsp; verwenden, was ein Leerzeichen in der neuen Zeile hinzufügt. Es wird Teil der Vorlage sein und eine Leerzeile erzeugen,

<a href="https://meta.discourse.org/new-topic?category==CATEGORY=&title=This is a topic created by =NAME=&body=Hello :wave:
&nbsp;
This is a test topic... Let's see the placeholder form.
\
Your email: =NAME=-=COUNTRY=@example.com">Use template as new topic</a>

---

3. Erstellen Sie eine Themenvorschau

Ausgewählte Kategorie

=CATEGORY=

Thema Titel

This is a topic created by =NAME=

Thema Text

Hello

This is a test topic… Let’s see the placeholder form.

Your email: =NAME=-=COUNTRY=@example.com

---

4. Erstellen Sie einen “Use template as new topic” Button (im obigen Beispiel ist dies ein Link, Sie können daraus einen Button machen)

Machen Sie ein [wrap] Element aus diesem Text. Dies macht es möglich, es mit CSS anzusprechen und zu gestalten. Ich füge dies unten hinzu.

<a href="https://meta.discourse.org/new-topic?category==CATEGORY=&title=This is a topic created by =NAME=&body=Hello :wave:
&nbsp;
This is a test topic... Let's see the placeholder form.
\
Your email: =NAME=-=COUNTRY=@example.com">[wrap=template-button]Use template as new topic[/wrap]</a>

Styling [wrap=template-button]
etwas wie

Common / CSS

[data-wrap="template-button"] {
  background: var(--tertiary);
  color: var(--secondary);
  border-radius: var(--d-button-border-radius);
  padding: 0.5em 0.65em;
  transition: background 0.25s;
  &:focus,
  &:hover {
    background: var(--tertiary-hover);
    color: var(--secondary);
  }
}

Der Vorlagen-Button wird so aussehen

---

Demo

Use template as new topic

---

Ich hoffe, dieses kleine Tutorial hilft jemandem, der etwas Ähnliches braucht

Bearbeitung: Ich habe eine Kategorieauswahl eingerichtet, die die Möglichkeit bietet, Themen in verschiedenen Kategorien zu erstellen.

---

Prüfen Sie die Rohversion dieses Beitrags…

[Lilly (Lillian)]

Das ist erstaunlich, Don, danke. Das passt tatsächlich sehr gut zu einem meiner Bedürfnisse

[jericson (Jon Ericson)]

Etwas zu beachten ist, dass Codeblöcke manchmal Probleme verursachen:

usermod -aG sudo =USERNAME=

In diesem Fall geht highlight.js davon aus, dass es sich um Java handelt und konvertiert den Codeblock zu:

<code>
  usermod -
  <span class="hljs-type">aG</span> 
  <span class="hljs-variable">sudo</span> 
  <span class="hljs-operator">=</span>
  USERNAME=
</code>

Ich kann es beheben, indem ich signalisiere, dass es sich tatsächlich um einen Shell-Befehl handelt:

    ```shell
    usermod -aG sudo =USERNAME=
    ```

Das führt zu:

usermod -aG sudo =USERNAME=

Wenn alles andere fehlschlägt, verhindert text, dass highlight.js mit den Platzhaltern herumspielt.

Eine allgemeinere Lösung (die Meta Discourse verwenden muss) besteht darin, die Einstellung default code lang von auto auf plaintext oder etwas Ähnliches zu ändern.

---

Nicht, dass es viel ausmacht, aber die Verwendung von java ist eine Möglichkeit, zu vermeiden, dass der Platzhalter erweitert wird, wenn Sie über Platzhalter schreiben möchten.

[putty]

Kannst du den Vorschau-Link überprüfen? Er scheint bei mir defekt zu sein.

[NateDhaliwal]

Dies ist eine erstaunliche Funktion, und ich sehe viele Anwendungsmöglichkeiten dafür.
Ist es jedoch in unserer Antwort möglich, =(name)= auszublenden, bis der Benutzer mit der Eingabe in das Textfeld beginnt? Ich glaube, dass Benutzer (insbesondere neue) ihren Zweck möglicherweise nicht verstehen oder dass es wie eine falsche Formatierung aussieht.

[JammyDodger]

@putty

Können Sie den Vorschau-Link überprüfen? Er scheint für mich defekt zu sein.

Ich glaube, ich habe wieder einen zum Laufen gebracht ( )

https://discourse.theme-creator.io/theme/Discourse/placeholder-forms

Ich habe ihn auch zu try.discourse.org hinzugefügt, damit Sie ihn ausgiebiger ausprobieren können.

[pfaffman (Jay Pfaffman)]

Vielleicht könnten Sie einen Standardwert eingeben, der stattdessen angezeigt wird.

[putty]

Das hat funktioniert! Danke!

[bangarang]

Diese Problemumgehung scheint nicht mehr zu funktionieren.

Gibt es andere Optionen, um reply-template und placeholder-forms zu kombinieren?