Kateに統合されたGit機能は、文書作成者の執筆作業を簡素化します。ファイルを変更したりブランチを切り替えたりするたびに、Gitコマンドを覚えたりターミナルに入力したりする必要はありません。
この記事は、様々な Fedora リポジトリで作業しているコントリビューターのための Kate の主な機能に焦点を当てています。これらの機能は他のリポジトリにも拡張できます。
ウェアハウスで使用するケイトの準備
- Pagure、GitLab、GitHubのアカウント設定にSSHキーを追加します。
- Pagure では - - にアクセスしてください。
- 在 GitLab 上， – –
- 在 GitHub 上， – –
- プロジェクトの複製：上流倉庫に移動し、" "ボタンを選択します。
- リポジトリのクローン
- フォークしたリポジトリで "" を選択します。
- 次に、リンクをクリップボードにコピーし、ターミナルのGIT URLに貼り付けます。
- リポジトリをクローンする際、追加パラメータとして新しいディレクトリ名を指定できます。
$ git clone <GIT URL>
- Kateをインストールします。Linuxユーザーであれば、ディストリビューションのパッケージマネージャーにアクセスしてKateをインストールします。Fedora Linuxを使用している場合は、Fedora Linux RPMバージョンまたはFlatpakをお勧めします。
セッション
Kateテキストエディタのセッション機能は、別々のプロジェクトをグループ化し、1つのビューで複数のドキュメントリポジトリを扱うのに役立ちます。
リポジトリをセッションに保存するには
""ドロップダウンメニューに移動 - "を選択 - クローンを作成するカタログを選択します。
ドロップダウンメニューから" "を選択 - セッション名を入力 - " "を押します。".
左側のペインで、Save to new session Magazine をクリックします。次に Kate を開くと、セッションに保存されたクローンリポジトリが再び表示されます。
ステータスバーを使ってブランチをチェックアウト
Kateエディターを使用すると、ステータスバーやポップアップ画面からブランチを切り替えたり、新しいブランチを作成したりできます。
現在のブランチはステータスバーの右下に表示されます。
新しいブランチを作成するには、「メイン」ブランチを選択します。ポップアップメニューから「」を選択し、新しいブランチ名を入力します。
AsciiDocハイライトの組み込みサポート
拡張子が AsciiDoc のファイルは asciidoc.xml のルールを使って自動的にハイライトされます。外部プラグインをインストールする必要はありません。
インスタントスペルチェック
入力中に自動的にスペルチェックを行いたい場合は、 Ctrl + Shift + O押します。このキーの組み合わせで、スペルチェックのオンとオフを切り替えることができます。
Git ツールビュー
左ペインのツール・ビューには、開いている各ファイルの Git ステータスが表示されます。
" " はファイルが追加されたことを意味し、上部の " " ボタンを選択するとコミットされます。
"" まだステージングされていない変更を表示します。
左パネル上部の " " ボタンをクリックすると、そのコミットの差分が表示されます。これにより、選択したコミットがコミットツールビューで開かれます。コミット内のすべての変更を表示したい場合は、右クリックして " " を選択し、コミットメッセージを追加します。
Git "" button is to the right of "" button.The Git "" button is to the right of "" button.
アイコンを選択すると、ステージングファイルとコミットが表示されます。
統合端末
F4 を押すか、" "ボタンを選択して、統合端子のオン/オフを切り替えます。
ビルドスクリプトとVale linterを統合ターミナルで使用することで、ライティングを次のレベルに引き上げ、ドキュメントの品質を確保することができます。
ステップ1.ビルドスクリプトの実行
ドキュメントの品質をローカルでチェックするには、統合ターミナルでビルドスクリプトとプレビュースクリプトを実行します。ビルドスクリプトとプレビュースクリプトにより、Antora Static Site Builder を通して、ドキュメントページにどのように変更が反映されるかを確認することができます。
注意: Fedora ドキュメントリポジトリの README ページをチェックして、ビルドスクリプトとインストラクションに正しいファイル名を使用してください。以下はその例です：
サイトを構築してプレビューするには、以下を実行してください：
$ ./docsbuilder.sh -p
プレビューを停止するには
$ ./docsbuilder.sh -k
経由:
