検索
ホームページウェブフロントエンドCSSチュートリアルWordPressブロックエディターでのマークダウンとローカリゼーションを使用します

WordPressブロックエディターでのマークダウンとローカリゼーションを使用します

WordPressエディター内にドキュメントを直接表示する必要がありますか?この記事では、合理化されたドキュメント管理とローカリゼーションのマークダウンを活用して、最適なアプローチを調査します。

ReactコンポーネントとHTMLは直感的に見えるかもしれませんが、広範なドキュメントのためにすぐに扱いにくく維持するのが難しくなる可能性があります。モーダルのドキュメントを示す以前の記事のこの例を考えてみましょう。

 const cachecontroldescription =()=> {
  戻る (
    <p>キャッシュコントロールヘッダーに<code>no-store if the max-age is 0</code>
  ))
}</p>

Markdownはよりクリーンなソリューションを提供します。上記は、マークダウンファイル( /docs/cache-control.md )にリファクタリングできます。

キャッシュコントロールヘッダーには、リクエストに関連するすべてのフィールド/ディレクティブからの最小最大年齢の値が含まれます。

Markdown vs. HTML:利点と短所

Markdownはプロセスを簡素化しますが、ポットファイルを使用して簡単に翻訳できるReactコンポーネントとは異なり、組み込みのローカリゼーションサポートがありません。ローカリゼーションは非常に重要であるため、この制限に対処します。この記事は、2つの重要な目的を達成することを目的としています。

  1. WordPressエディターブロック内のドキュメントにMarkdownを使用します。
  2. ユーザーの言語に基づいてドキュメント翻訳を実装します。

マークダウンコンテンツのロード

/docs/cache-control.mdが作成されていると、HTMLコンテンツをインポートおよびレンダリングできます。

 '../docs/cache-control.md'からのcachecontroldocumentationをインポートします。

const cachecontroldescription =()=> {
  戻る (
    <div dangerouslysetinnerhtml="{{" __html: cachecontroldocumentation></div>
  );
}

これは、WordPressエディターのコアモジュールバンドラー(バージョン4.42)であるWebpackに依存しています。 MarkdownとHTMLローダーを処理するように、Webpackの構成をカスタマイズします。

ブロックのルートでwebpack.config.jsを作成します。

 const defaultconfig = require( '@wordpress/scripts/config/webpack.config');

module.exports = {
  ... defaultconfig、
  モジュール:{
    ... defaultconfig.module、
    ルール:[
      ... defaultconfig.module.rules、
      {
        テスト:/\.md$/、
        使用: [
          {Loader: "HTML-Roader"}、
          {ローダー:「マークダウンローダー」}
        ]
      }
    ]、、
  }、
};

必要なパッケージをインストールします:

 npmインストール -  save-dev markdown-roader html-roader

改善された組織については、Webpackエイリアス( @docsを指す/docs )を追加します。

 const path = require( 'path');
config.resolve.alias ['@docs'] = path.resolve(process.cwd()、 'docs/');

今では輸入が簡素化されます:

 '@docs/cache-control.md'からのcachecontroldocumentationをインポートします。

ローカライズドキュメント

直接マークダウンの翻訳は実行不可能であるため、言語固有のマークダウンファイルを作成します。

  • /docs/en/cache-control.md
  • /docs/fr/cache-control.md
  • /docs/zh/cache-control.mdなど。

このアプローチは、領域固有のバリエーション( /docs/en_US/cache-control.mdなど)を処理することもできます。

ユーザー言語の取得

ユーザーの言語はget_locale()を使用して取得され、解析されて言語コードを抽出します。

関数get_locale_language():string {
  $ localeparts = Explode( '_'、get_locale());
  $ localeparts [0]を返します。
}

この言語コードはwp_localize_script()を介してブロックに渡されます。

 wp_localize_script(
  $ blockscriptregistrationName、
  「graphqlapicachecontrol」、
  [
    'userlang' => get_locale_language()、
  ]
);

window.graphqlApiCacheControl.userLangとしてブロックにアクセスできるようになりました。

動的なインポート

ユーザーの言語は実行時にのみ知られているため、動的なインポートを使用します。

 const lang = window.graphqlapicachecontrol.userlang;
import( `@docs/$ {lang}/cache-control.md`).then(module => {
  // ...
});

コンテンツはobj.defaultを介してアクセスされます。

 const cachecontrolcontent = import( `@docs/$ {lang}/cache-control.md`).then(obj => obj.default);

これは、 getMarkdownContent関数にカプセル化されています。

 const getMarkDownContent =(filename、lang)=> {
  return import(/ * webpackchunkname: "docs/[request]" */`@docs/$ {lang}/$ {filename} .md`)
    .then(obj => obj.default);
};

/* webpackChunkName: "docs/[request]" */ commentは、組織化されたチャンク管理を保証します。

パブリックパスを設定します

publicPathは、Webpackが動的にロードされたチャンクを見つけるために重要です。これは、ハードコーディング、環境変数を介して設定する、または実行時に渡されることができます。この例では、渡します。

 $ blockpublicpath = plagin_dir_url(__ file__)。 '/blocks/cache-control/build/';
wp_localize_script(
  $ blockscriptregistrationName、
  「graphqlapicachecontrol」、
  [
    // ...
    「publicpath」=> $ blockpublicpath、
  ]
);

次に、JavaScript側に設定します。

 __webpack_public_path__ = window.graphqlapicachecontrol.publicpath;

デフォルトの言語フォールバック

フォールバックメカニズムは、欠落している翻訳を処理します:

 const getMarkDownContentOruseDefault =(filename、defaultlang、lang)=> {
  return getMarkDownContent(Filename、Lang)
    .catch(err => getMarkDownContent(filename、defaultlang));
};

モーダルとの統合

最後に、マークダウンコンテンツはモーダルに統合されます。

 '@wordpress/element'から{ueseState、useefcect}をimportします。
// ...その他の輸入

const cachecontrolcontentmodal =(props)=> {
  // ...
  const [page、setpage] = uesestate([]);

  effect(()=> {
    GetMarkDownContentorUsedEfault(Filename、DefaultLang、Lang)。
      setpage(value);
    });
  }、[]);

  戻る (
    <contentmodal content="{page}"></contentmodal>
  );
};

このアプローチは、WordPressエディター内の堅牢で保守可能な、ローカライズされたドキュメントシステムを提供します。

以上がWordPressブロックエディターでのマークダウンとローカリゼーションを使用しますの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
cohost.orgの失われたCSSトリックcohost.orgの失われたCSSトリックApr 25, 2025 am 09:51 AM

この投稿では、Blackle Moriは、CohostのHTMLサポートの限界を押し広げようとしている間に見つかったハックのいくつかを示します。あえてこれらを使用してください、あなたもCSS犯罪者とラベル付けされないようにしてください。

カーソルの次のレベルCSSスタイリングカーソルの次のレベルCSSスタイリングApr 23, 2025 am 11:04 AM

CSSを備えたカスタムカーソルは素晴らしいですが、JavaScriptを使用して次のレベルに物事を引き出すことができます。 JavaScriptを使用して、カーソル状態間で移行し、カーソル内に動的テキストを配置し、複雑なアニメーションを適用し、フィルターを適用できます。

Worlds Collide:スタイルクエリを使用したキーフレーム衝突検出Worlds Collide:スタイルクエリを使用したキーフレーム衝突検出Apr 23, 2025 am 10:42 AM

2025年には、互いに互いに跳ね返る要素を伴うインタラクティブなCSSアニメーションは、CSSにPongを実装する必要はありませんが、CSSの柔軟性とパワーの増加はLee&#039;の疑いを補強します。

UI効果にCSSバックドロップフィルターを使用しますUI効果にCSSバックドロップフィルターを使用しますApr 23, 2025 am 10:20 AM

CSSバックドロップフィルタープロパティを使用してユーザーインターフェイスをスタイルするためのヒントとコツ。バックドロップフィルターを複数の要素間でレイヤー化する方法を学び、それらを他のCSSグラフィカル効果と統合して、精巧なデザインを作成します。

微笑んでいますか?微笑んでいますか?Apr 23, 2025 am 09:57 AM

まあ、SVG&#039;の組み込みのアニメーション機能は、計画どおりに非推奨されることはありませんでした。確かに、CSSとJavaScriptは負荷を運ぶことができる以上のものですが、以前のようにSmilが水中で死んでいないことを知っておくのは良いことです

「かわいい」は見る人の目にあります「かわいい」は見る人の目にありますApr 23, 2025 am 09:40 AM

イェーイ、テキストワラップのジャンプを見てみましょう:サファリテクノロジーのプレビューにかなり着陸してください!しかし、それがChromiumブラウザーでの仕組みとは異なることに注意してください。

CSS-Tricks XLIIIを記録しますCSS-Tricks XLIIIを記録しますApr 23, 2025 am 09:35 AM

このCSS-Tricksアップデートは、アルマナック、最近のポッドキャスト出演、新しいCSSカウンターガイド、および貴重なコンテンツを提供するいくつかの新しい著者の追加の大幅な進歩を強調しています。

Tailwind&#039;の@Apply機能は、響きよりも優れていますTailwind&#039;の@Apply機能は、響きよりも優れていますApr 23, 2025 am 09:23 AM

ほとんどの場合、人々はTailwind&#039;の@Apply機能を紹介します。このように展示されたとき、@Applyはまったく有望な音をしません。だからobvio

See all articles

ホットAIツール

Undresser.AI Undress

Undresser.AI Undress

リアルなヌード写真を作成する AI 搭載アプリ

AI Clothes Remover

AI Clothes Remover

写真から衣服を削除するオンライン AI ツール。

Undress AI Tool

Undress AI Tool

脱衣画像を無料で

Clothoff.io

Clothoff.io

AI衣類リムーバー

Video Face Swap

Video Face Swap

完全無料の AI 顔交換ツールを使用して、あらゆるビデオの顔を簡単に交換できます。

ホットツール

PhpStorm Mac バージョン

PhpStorm Mac バージョン

最新(2018.2.1)のプロフェッショナル向けPHP統合開発ツール

mPDF

mPDF

mPDF は、UTF-8 でエンコードされた HTML から PDF ファイルを生成できる PHP ライブラリです。オリジナルの作者である Ian Back は、Web サイトから「オンザフライ」で PDF ファイルを出力し、さまざまな言語を処理するために mPDF を作成しました。 HTML2FPDF などのオリジナルのスクリプトよりも遅く、Unicode フォントを使用すると生成されるファイルが大きくなりますが、CSS スタイルなどをサポートし、多くの機能強化が施されています。 RTL (アラビア語とヘブライ語) や CJK (中国語、日本語、韓国語) を含むほぼすべての言語をサポートします。ネストされたブロックレベル要素 (P、DIV など) をサポートします。

MinGW - Minimalist GNU for Windows

MinGW - Minimalist GNU for Windows

このプロジェクトは osdn.net/projects/mingw に移行中です。引き続きそこでフォローしていただけます。 MinGW: GNU Compiler Collection (GCC) のネイティブ Windows ポートであり、ネイティブ Windows アプリケーションを構築するための自由に配布可能なインポート ライブラリとヘッダー ファイルであり、C99 機能をサポートする MSVC ランタイムの拡張機能が含まれています。すべての MinGW ソフトウェアは 64 ビット Windows プラットフォームで実行できます。

MantisBT

MantisBT

Mantis は、製品の欠陥追跡を支援するために設計された、導入が簡単な Web ベースの欠陥追跡ツールです。 PHP、MySQL、Web サーバーが必要です。デモおよびホスティング サービスをチェックしてください。

EditPlus 中国語クラック版

EditPlus 中国語クラック版

サイズが小さく、構文の強調表示、コード プロンプト機能はサポートされていません