次のドキュメント Reload_html/css_WEB-ITnose

NextT テーマの主な目標は常にシンプルさと使いやすさですが、現実とアイデアの間には常にギャップがあります。詩は人生から生まれたものであり、詩よりも劣っていると言う人がいるのも不思議ではありません。実はそれには深い哲学的な理由があるのです。したがって、その背後にある理由が何であれ、要約すると、NexT は使いにくいということになります。ユーザーが比較的少なかった初期の頃は、根気よく一つずつ答えていましたが、後になって、同じような質問に答えていたことに気づき、やるべきこと、やりたいことが多すぎたので、この問題を解決するためのドキュメントを見てみましょう。

前シーズンのプロットレビュー

まず、Hexo を使用して NextT 使用法ドキュメント サイトの最初のバージョンを構築しました。選択された UI フレームワークは Semantic UI で、Luminosa と呼ばれる新しいテーマが作成されます。ただし、Markdown で Semantic UI コンポーネントを使用するのは少し面倒で、Hexo は Markdown を解析するときに自動的に大量の空白行を追加してしまうことがわかりました。最後の手段として、使用するセマンティック UI のコンポーネントをカプセル化するタグ プラグインをいくつか作成することしかできませんでした。

これは、プラグインの作成にすべての時間を費やしたため、セマンティック UI を使用している場合でも、インターフェイス全体が依然として非常に粗くて雑な理由の説明にもなります。文書の品質については、春の野原では長い間忘れられてきました。結局のところ、夏はサンシャインとビキニが共存する日です。ドキュメントのことは忘れてください（以前、熱心なユーザーが Docs に PR を送信したことを思い出します。私はそれをマージしませんでした。申し訳ありません）。しかし、時は容赦なく、夏の景色を十分に見ないうちに、あっという間に秋が来てしまいました。秋は文人や詩人が先導する季節です。そんな慌ただしい季節に、私は自分の魂への賞賛を表現できるのは「笑」だけだと気づきました。

短期計画がめちゃくちゃになってしまいました

ということで、忙しい仕事を終えて少し自由時間ができたので、最近の自由時間を NextT ドキュメントの再作成と作成に費やしました。現在の計画では、近い将来にリリースをリリースし、バージョン番号を 0.4 から 5.0.0 に直接アップグレードする予定です (Facebook の足跡をたどります)。このリリースには主に Pisces Scheme が含まれており、Pisces によって導入されたバグの修正とドキュメントの更新が含まれています。この後、主に問題で報告されたバグを解決するための小さなアップデートが行われるはずです。次のステップは、サイドバーを書き換えて画像を表示することです（このことは脇に置きました）。短期計画としてはこれでほぼ終わりです。

ドキュメントの再インストール

ドキュメントに戻ります。最初のバージョンの経験に基づいて、2 番目のバージョンでは Hexo を使用しないことが決定されました。 Markdown で HTML コードの大部分を記述するには、HTML コードを直接記述することもできますが、構造タグ (実際には多くのタグ) を記述することを除けば、HTML の記述は比較的簡単です。この利点は、コンテンツ レイヤーの制御が容易になり、外観や動作に障害がなくなることです。

2 番目のバージョンでは、Nunjucks テンプレート エンジン、Sass 前処理言語、Gulp ビルド ツールを使用して、UI フレームワークとして Bootstrap を選択しました。最初は、テクノロジースタックはそれほど高級なものではなく、ただ良い文書を書きたかっただけでしたが、3 ページ目を書いたときに我慢できなくなり、同じ文書の内容を最初から最後までコピーしなければなりませんでした。この公開コンテンツを適切に文書化する必要がある場合は、毎回このようなことが起こります。

そこでNunjucksが紹介されました。テンプレート エンジンを使用する場合は、開発プロセスと展開コード生成プロセスを含む、テンプレートからページを生成する問題を解決する必要があります。幸いなことに、この問題は難しくありません。 Nunjucks の API を使用してレンダラを生成すると、BrowserSync のミドルウェアや Gulp のデプロイメント生成タスクで使用できます。テンプレートのレンダリングの問題は正常に解決されました。したがって、ドキュメントの大部分は HTML コードであり、唯一の例外はコード スニペットです。 HTML で HTML ソース コードを記述するには、多数の < と > を変換する必要があることを考慮して、コード スニペットをすばやく挿入するための code タグを追加しました。

広告を挿入して、自動更新、マルチデバイス同期、ミドルウェア サポート、およびプロキシ サポートを備えたアーティファクトである BrowserSync をダウンロードします。これは、フロントエンド開発には必須のアーティファクトです。それを知っています。私はかつてプロジェクトで Grunt をデュアル Watcher として使用しました。最初の Watcher はソース コードの変更を監視し、事前にデプロイされたコードを生成するために使用され、2 番目の Watcher は事前にデプロイされたコードを監視し、アプリケーション コンテナにコードをデプロイするために使用されました。 BrowserSync を使用すると、1 つの Watcher と Proxy だけでこのシナリオのニーズを簡単に解決できます。 BrowserSync を使用して以来、気分が数年若くなり、階段を上るときに元気に感じます (時代遅れの広告コピーライティングよりも)。

一般的なフレームワークが完成すると、ドキュメントの内容が利用可能になります。既存の文書の内容を時間をかけて磨き直し、あらゆる点を詳細に書き留めるように努め、今も書き続けています（「書く」という言葉は非常に強力で、文書を書くことの難しさを直接示しています。係数）非常に高いです）。その後、NexT には多くの機能が含まれており、そのうちのいくつかは私が使用していないことがわかりました。したがって、不足しているものを見つけた場合は、NextT ドキュメントにアクセスして問題を投稿するか、プル リクエストを投稿するとよいでしょう。