ヴィテプレスとは何ですか？ vuepress を vitepress にアップグレードするにはどうすればよいですか?

ヴァイテプレスとは何ですか?この記事では、vitepress の利点を説明し、vuepress を vitepress にアップグレードする方法を紹介します。

vue3 が登場する前は、誰もが vuepress を使用したり聞いたことがあると思いますが、これはドキュメントの作成に使用できる vue ベースの静的 Web サイト ジェネレーターです。具体的な内容については、VuePress 公式 Web サイトをご覧ください。
しかし、現在は vue3 があり、vite もあり、さらに vite の上に vitepress が構築されています。 (Vitepress によって生成されるモチベーションについては、公式 Web サイトで説明を確認できます)。 [関連する推奨事項: "vue.js チュートリアル "]

vitepress の利点

• Webpack ではなく vite に基づいており、起動時間はすべて高速化され、ホット リロードが可能です。 etc
• vue3 を使用して js のペイロードを削減します

.vitepress/config.js

vitepress の改善

vue3# を使用しました

• vue3 の改良されたテンプレート静的分析を使用して、静的コンテンツを可能な限り文字列化しました

• vite を使用しました
  • 開発サービスの起動の高速化

  • ホット アップデートの高速化

  • ビルドの高速化 (ロールアップを使用)

##より軽量なページ

#vue 3 Tree Shake Rollup Code Separation

すべてのページのメタデータは送信されません1つのリクエストで。クライアントが移動すると、新しいページのコンポーネントとメタデータが一緒に取得されます。
• 未使用 vue-router
• (WIP) i18n ローカリゼーション データは必要に応じて要求されます
相違点

vitepress の構成が少なくなります。 vitepress の目標は、現在の vuepress の複雑さを軽減し、ミニマリズムの根本からやり直すことです。

は未来志向です。ターゲット ブラウザは、ネイティブ ES モジュールのインポートのみをサポートするブラウザです。エスケープの代わりにネイティブ JS を使用し、対象に CSS 変数を使用することを推奨します。
• アップグレード プロセス

以下で使用する vitepress はバージョン v0.20.0

1. vitepress

npm install vitepress

をインストールします。vuepress を使用すると、必ず

docs

フォルダーが存在することがわかります (ない場合は、作成できます)それはあなた自身です）。

2. エントリ ファイルをindex.mdに変更します

注: vuepressのエントリ ファイルは docs/readme.md、vitepressのエントリ ファイルはindex.mdです。元の readme の名前を変更するには、

index.md に他のコンテンツがない場合は、単純なコンテンツを追加できます

---
home: true
title: 主页
lang: en-US
heroText: BIFE文档库
tagline: 这是你的舞台，期待你的精彩
actionText: Get Started
actionLink: /新人须知/first-day
footer: MIT Licensed | Copyright © 2021-present CoolDream
---

3. vitepress 情報の設定

.vitepress

Folder
• を作成します。config の
.vitepress
• config.js の下に構成ファイルを作成します。 js
構成情報を追加します
• <pre class='brush:php;toolbar:false;'>export default { base: &amp;#39;&amp;#39;, // 项目的基础路径 title: &amp;#39;文档&amp;#39;, // 文档的标题，会显示在 description: &amp;#39;前端技术文档&amp;#39;, // 文档描述 lastUpdated: &amp;#39;上次更新时间&amp;#39;, // string | boolean }</pre>4。上部に適切なナビゲーションを追加したい場合は、
themeConfig# に

module.exports = {
    themeConfig: {
        // 顶部右侧导航
        nav: [
            { text: 'Home', link: '/first-day' },
            {
                text: 'Components',
                link: '/test'
            },
        ],
    }
}

を追加します。 ## 注: nav ナビゲーション リンクは、リンクされたファイル名と一致している必要があり、大文字と小文字が区別されます

5。左側のナビゲーションを追加し、

も追加します。

themeConfig

vuepress の子リンクは特定のリンクであり、表示されるナビゲーション名は各 .md ファイルのタイトルであることに注意してください。

vitepress の子はオブジェクト配列であり、テキストはナビゲーション名を表し、リンクは実際のリンクです。

複数のルートがある場合は、次のことを確認してください。最後にデフォルト ルートを書き込みます

module.exports = {
    themeConfig: {
        // 侧边栏
        sidebar: [
            '/CHANGLOG':[
                {
                    text: '更新日志'
                }
            ],
            '/': [
                {
                    text: '新人须知',
                    children: [
                        {
                          text: '入职第一天',
                          link: '/first-day'
                        },
                        {
                            text: '入职第一周',
                            link: '/first-week'
                        }
                     ]
                 }
             ]
        ],
        
    }
}

6. スクリプトを

package.json

"scripts": {
    "dev": "vitepress dev docs",
    "build": "vitepress build docs",
    "notice": "sh scripts/notice.sh"
 },

に追加します。vuepress

npm uninstall vuepress

## をアンインストールします#アップグレード中に発生した問題複数のルートを切り替えると反映されない

最初はデフォルトルートを先頭に記述していましたが、ルートを切り替えてもルートが更新されないことがわかりました。 , そして、それはまだデフォルトルートでした。後で、デフォルトルートを置く必要があることがわかりました。最後の

themeConfig:{
    // 侧边栏
    sidebar: {
        // 其他路由在前
        'other-router':[],
        // 默认路由在最后
        '/': [
            {
                text: '新人须知',
                children: [
                    {
                      text: '入职第一天',
                      children: [
                          {text: '电脑'}
                      ]
                    }
                ]
            }
        ]
     }
}

マークダウンにテーブル形式で記述します (ビルド時にエラーが報告されます)

データ型の後にスペースを入れることはできません。エラーで報告された行数がまったく一致しないため、トラブルシューティングが必要になります。(長時間にわたって) 以下に示すように

#ファイルの内部リンク パスは .md であるか省略する必要があり、他のファイル タイプは使用できません (ビルド時にエラーが報告されます)

vitepress は、ファイルの最後のレベルを変換します。

*.html

へのパス (/

で終わる場合は、戻ってフォルダー内で

index.md

を見つけます)、他のファイル タイプの場合、

*.txt、ファイル は見つかりません。

マークダウン内のリンクに中国語を含めることはできません (ビルド時にエラーが報告されます)

マークダウン内にそのようなリンク形式がある場合[Technology Sharing](/Technology Sharing/WebComponents/)、npm run build 時にエラーが報告されます。エラー メッセージは次のとおりです。この場合、代わりに <a href=""></a> タグ リンクを使用してください

マークダウン内のリンクには http プロトコルが必要です (ビルド時にエラーが報告されます)

http プロトコルがない場合もエラーが報告されます

プログラミング関連の知識については、プログラミング入門をご覧ください。 ！

以上がヴィテプレスとは何ですか？ vuepress を vitepress にアップグレードするにはどうすればよいですか?の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。