Verwenden von Markdown und Lokalisierung im WordPress -Block -Editor
Apr 02, 2025 am 04:27 AMMüssen Dokumentation direkt im WordPress -Editor angezeigt? In diesem Artikel wird der optimale Ansatz untersucht und den Markdown für optimiertes Dokumentationsmanagement und Lokalisierung eingesetzt.
W?hrend React -Komponenten und HTML intuitiv erscheinen m?gen, k?nnen sie schnell unhandlich und für umfangreiche Dokumentation schwer aufrechterhalten werden. Betrachten Sie dieses Beispiel aus einem früheren Artikel, der die Dokumentation in einem Modal zeigt:
const cachecontroldroldescription = () => { zurückkehren ( <p>Der Cache-Control-Header enth?lt den Mindestwert maximal maximal nach allen Feldern/Richtlinien, die an der Anforderung beteiligt sind, oder <code>no-store if the max-age is 0</code> ) }</p>
Markdown bietet eine sauberere L?sung. Die oben genannten k?nnte in eine Markdown-Datei ( /docs/cache-control.md
) umgerichtet werden:
Der Cache-Control-Header enth?lt den Mindestwert maximal maximal AAGE aus allen Feldern/Anweisungen, die an der Anfrage beteiligt sind
Markdown vs. HTML: Vor- und Nachteile
Markdown vereinfacht den Prozess, aber im Gegensatz zu React-Komponenten, die eine einfache übersetzung mithilfe von POT-Dateien erm?glichen, fehlt es in der integrierten Lokalisierung. Da die Lokalisierung von entscheidender Bedeutung ist, werden wir uns mit dieser Einschr?nkung befassen. Dieser Artikel zielt darauf ab, zwei Hauptziele zu erreichen:
- Verwendung von Markdown für Dokumentation in einem WordPress -Editor -Block.
- Implementierung der Dokumentationsübersetzung basierend auf der Sprache des Benutzers.
Laden von Markdown -Inhalten
Mit /docs/cache-control.md
erstellt, k?nnen wir seinen HTML-konvertierten Inhalt importieren und rendern:
importieren Sie CacheControldocumentation aus '../docs/cache-control.md'; const cachecontroldroldescription = () => { zurückkehren ( <div dangerouslysetinnerhtml="{{" __html: cachecontroldocumentation></div> ); }
Dies basiert auf WebPack, dem Core -Modul des WordPress -Editors (Version 4.42). Wir werden die Konfiguration von WebPack an die Verarbeitung von Markdown- und HTML -Loader anpassen.
Erstellen Sie webpack.config.js
im Root des Blocks:
const defaultConfig = required ('@wordpress/scripts/config/webpack.config'); module.exports = { ... Standardconfig, Modul: { ... defaultConfig.module, Regeln: [ ... defaultConfig.module.rules, { Test: /\.md$/,, verwenden: [ {Loader: "html-loader"}, {Loader: "Markdown-Loader"} ] } ], }, };
Installieren Sie die erforderlichen Pakete:
NPM-Installation-Save-Dev Markdown-Lader HTML-Lader
Für eine verbesserte Organisation fügen Sie einen Webpack -Alias ??hinzu ( @docs
der zu /docs
zeigt):
const path = fordern ('path'); config.resolve.alias ['@docs'] = path.resolve (process.cwd (), 'docs/');
Jetzt vereinfacht die Importe zu:
importieren Sie CacheControldocumentation aus '@docs/cache-control.md';
Lokalisierung der Dokumentation
Da direkte Markdown-übersetzung nicht m?glich ist, erstellen wir sprachspezifische Markdown-Dateien:
-
/docs/en/cache-control.md
-
/docs/fr/cache-control.md
-
/docs/zh/cache-control.md
usw. usw.
Dieser Ansatz kann auch regionspezifische Variationen verarbeiten (EG, /docs/en_US/cache-control.md
).
Abrufen der Benutzersprache
Die Sprache des Benutzers wird mit get_locale()
erhalten und analysiert, um den Sprachcode zu extrahieren:
Funktion get_locale_Language (): String { $ localparts = explode ('_', get_locale ()); $ localparts [0] zurückgeben; }
Dieser Sprachcode wird über wp_localize_script()
an den Block übergeben:
wp_localize_script ( $ blockscripTregistrationName, 'GraphQlapicacheControl', [ 'userlang' => get_locale_Language (), ] );
Jetzt im Block zug?nglich als window.graphqlApiCacheControl.userLang
.
Dynamische Importe
Da die Sprache des Benutzers nur zur Laufzeit bekannt ist, verwenden wir dynamische Importe:
const lang = window.graphqlapicacheControl.userlang; import (`@docs/$ {lang}/cache-control.md`) .then (module => { // ... });
Der Inhalt wird über obj.default
zugegriffen:
const cachecontrolContent = import (`@docs/$ {Lang}/cache-control.md`) .then (obj => obj.default);
Dies ist in einer getMarkdownContent
-Funktion eingekapselt:
const getMarkdownContent = (Dateiname, Lang) => { Rückgabe import (/ * webpackchunkname: "docs/[request]" */`@docs/$ {lang}/$ {Dateiname} .md`) .then (obj => obj.default); };
Der /* webpackChunkName: "docs/[request]" */
Kommentar sorgt für das organisierte Chunk -Management.
Den ?ffentlichen Weg setzen
Der publicPath
ist für Webpack von entscheidender Bedeutung, um die dynamisch geladenen Stücke zu lokalisieren. Dies kann hartcodiert, über eine Umgebungsvariable festgelegt oder zur Laufzeit bestanden werden. In diesem Beispiel werden wir es bestehen:
$ blockPublicPath = plugin_dir_url (__ Datei__). '/blocks/cache-control/build/'; wp_localize_script ( $ blockscripTregistrationName, 'GraphQlapicacheControl', [ // ... 'publicPath' => $ blockPublicPath, ] );
Stellen Sie es dann auf der JavaScript -Seite ein:
__Webpack_public_path__ = window.graphqlapicacheControl.publicPath;
Standardsprachenfall
Ein Fallback -Mechanismus behandelt fehlende übersetzungen:
const getMarkdownContentorUsefault = (Dateiname, defaultInd, Lang) => { Return getMarkdownContent (Dateiname, Lang) .Catch (err => getMarkdownContent (Dateiname, defaultAnd)); };
Integration in das Modal
Schlie?lich ist der Markdown -Inhalt in das Modal integriert:
importieren {usustate, useEffect} aus '@WordPress/Element'; // ... andere Importe const cachecontrolContentModal = (Props) => { // ... const [Seite, setPage] = usustate ([]); useEffect (() => { GetmarkdownContentorUsedEfault (Dateiname, defaultIlt, Lang) .then (value => { SetPage (Wert); }); }, []); zurückkehren ( <contentmodal content="{page}"></contentmodal> ); };
Dieser Ansatz bietet ein robustes, wartbares und lokalisiertes Dokumentationssystem innerhalb des WordPress -Editors.
Das obige ist der detaillierte Inhalt vonVerwenden von Markdown und Lokalisierung im WordPress -Block -Editor. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!

Hei?e KI -Werkzeuge

Undress AI Tool
Ausziehbilder kostenlos

Undresser.AI Undress
KI-gestützte App zum Erstellen realistischer Aktfotos

AI Clothes Remover
Online-KI-Tool zum Entfernen von Kleidung aus Fotos.

Clothoff.io
KI-Kleiderentferner

Video Face Swap
Tauschen Sie Gesichter in jedem Video mühelos mit unserem v?llig kostenlosen KI-Gesichtstausch-Tool aus!

Hei?er Artikel

Hei?e Werkzeuge

Notepad++7.3.1
Einfach zu bedienender und kostenloser Code-Editor

SublimeText3 chinesische Version
Chinesische Version, sehr einfach zu bedienen

Senden Sie Studio 13.0.1
Leistungsstarke integrierte PHP-Entwicklungsumgebung

Dreamweaver CS6
Visuelle Webentwicklungstools

SublimeText3 Mac-Version
Codebearbeitungssoftware auf Gottesniveau (SublimeText3)

Hei?e Themen

CSS -Bl?cke Seitenrenderung, da Browser inline und externe CSS standardm??ig als wichtige Ressourcen anzeigen, insbesondere mit importierten Stylesheets, Header gro?er Mengen an Inline -CSS und nicht optimierten Medienfragestilen. 1. extrahieren kritische CSS und einbetten Sie es in HTML ein; 2. Verz?gerung des Ladens nichtkritischer CSS durch JavaScript; 3.. Verwenden Sie Medienattribute, um das Laden wie Druckstile zu optimieren. 4. Komprimieren und verschmelzen CSS, um Anfragen zu reduzieren. Es wird empfohlen, Tools zum Extrahieren von Schlüssel -CSS zu verwenden, REL = "Vorspannung" zu kombinieren, und verwenden Sie die asynchrone Belastung und verwenden Sie die Medienverz?gerungsladeverletzung, um eine überm??ige Aufteilung und eine komplexe Skriptsteuerung zu vermeiden.

AutoPrefixer ist ein Tool, das die Pr?fixe von Anbietern automatisch zu CSS -Attributen basierend auf dem Zielbrowserbereich hinzufügt. 1. Es l?st das Problem, die Pr?fixe mit Fehlern manuell aufrechtzuerhalten. 2. Arbeiten Sie das POSTCSS-Plug-in-Formular durch, analysieren Sie CSS, analysieren Sie Attribute, die vorangestellt werden müssen, und generieren Sie den Code gem?? Konfiguration. 3.. 4. Notizen enthalten nicht manuelles Hinzufügen von Pr?fixen, Konfigurationsaktualisierungen, Pr?fixe nicht alle Attribute, und es wird empfohlen, sie mit dem Pr?prozessor zu verwenden.

Theconic-Gradient () FunctionincsScreateScircular GradecentStroTRotateColorStopsaroundAcentralPoint.1.ISISIDEALFORPieCharts, Fortschrittsindikatoren, Farbw?sche und DecorativeBackgrounds.2

TocreatestickyHeadersandfooterswithcss, Anwendungseinstellung: Stickyforheaderswithtopvalueandz-Index, sicherstellen, dass ParentContainersdon'Trictit.1.ForstickyHaaders: Einstellungen: Kleber, Top: 0, Z-Index und BackgroundColor.2.

Der Umfang der benutzerdefinierten CSS -Eigenschaften h?ngt vom Kontext ihrer Erkl?rung ab. Globale Variablen werden normalerweise in: root definiert, w?hrend lokale Variablen in einem bestimmten Selektor für die Komponentierung und Isolierung von Stilen definiert werden. Zum Beispiel sind Variablen, die in der .card -Klasse definiert sind, nur für Elemente zur Verfügung, die der Klasse und ihren Kindern entsprechen. Zu den Best Practices geh?ren: 1. Verwendung: Wurzel zur Definition globaler Variablen wie Themenfarbe; 2. Definieren Sie lokale Variablen innerhalb der Komponente, um die Kapselung zu implementieren. 3.. Vermeiden Sie es, wiederholt die gleiche Variable zu deklarieren; 4. Achten Sie auf die Abdeckungsprobleme, die durch Selektorspezifit?t verursacht werden k?nnen. Zus?tzlich sind CSS -Variablen Fallempfindlichkeit und sollten vor dem Gebrauch definiert werden, um Fehler zu vermeiden. Wenn die Variable undefiniert ist oder die Referenz fehlschl?gt, wird der Fallback -Wert oder den Standardwert anf?nglich verwendet. Debugg kann über den Browser -Entwickler durchgeführt werden

Mobile-firstcsSdeSignRequiressettingTheviewPortMetatag, Verwenden von Relativen, StylingFromsMallScreensUp, Optimierungstypographie und touchtargets.First, addtocontrolscaling.second, verwenden Sie%, EM, orreminsteadofpixelforflexiblelayouts.thirds, thishirds

Es gibt drei M?glichkeiten, einen CSS -Laderotator zu erstellen: 1. Verwenden Sie den Basisrotator der Grenzen, um eine einfache Animation durch HTML und CSS zu erreichen. 2. Verwenden Sie einen benutzerdefinierten Rotator mit mehreren Punkten, um den Sprungeffekt durch verschiedene Verz?gerungszeiten zu erreichen. 3. Fügen Sie einen Rotator in die Taste hinzu und wechseln Sie den Klassen über JavaScript, um den Ladestatus anzuzeigen. Jeder Ansatz betont die Bedeutung von Entwurfsdetails wie Farbe, Gr??e, Zug?nglichkeit und Leistungsoptimierung, um die Benutzererfahrung zu verbessern.

Um das gesamte Netzlayout im Ansichtsfenster zentriert zu machen, kann es mit den folgenden Methoden erreicht werden: 1. Rand: 0Auto, um horizontales Zentrieren zu erreichen, und der Container muss so eingestellt werden, dass die feste Breite festgelegt wird, die für festes Layout geeignet ist. 2. Verwenden Sie Flexbox, um die Eigenschaften der Rechtfertigung und Ausrichtung der Eigenschaften des Au?enbeh?lters einzustellen, und kombinieren Sie Min-H?he: 100 VH, um vertikale und horizontale Zentrierung zu erzielen, was für Szenarien mit Vollbild-Displays geeignet ist. 3. Verwenden Sie CSSGrid's Place-Items-Eigenschaft, um sich schnell auf den übergeordneten Container zu konzentrieren, der einfach ist und eine gute Unterstützung von modernen Browsern hat. Gleichzeitig ist es erforderlich, sicherzustellen, dass der Elternbeh?lter eine ausreichende H?he hat. Jede Methode hat anwendbare Szenarien und Einschr?nkungen. W?hlen Sie einfach die entsprechende L?sung gem?? den tats?chlichen Bedürfnissen aus.
