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つの重要な目的を達成することを目的としています。
- WordPressエディターブロック内のドキュメントにMarkdownを使用します。
- ユーザーの言語に基づいてドキュメント翻訳を実装します。
マークダウンコンテンツのロード
/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 サイトの他の関連記事を参照してください。

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

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

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

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

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

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

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

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


ホットAIツール

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

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

Undress AI Tool
脱衣画像を無料で

Clothoff.io
AI衣類リムーバー

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

人気の記事

ホットツール

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

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

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

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

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

ホットトピック









