Pi_spec

這是一個用於處理 rpm spec 檔案的檔案類型外掛。

目前，這個 Vim 外掛讓您可以輕鬆更新 RPM spec 檔案中的 %changelog 區塊。如果該區塊還不存在，它甚至會為您建立一個。如果您今天已經插入了一個條目，它會讓您有機會直接在今天的條目中新增一個新項目。如果您沒有提供格式字串 (spec_chglog_format)，它會詢問您的電子郵件地址並自行建立一個格式字串。

1. 如何使用它 spec-how-to-use-it 2. 自訂 spec-customizing

spec_chglog 外掛提供如下的映射：

:map <buffer> <LocalLeader>c <Plug>SpecChangelog

這表示您可以在 spec 檔案內按下您的 maplocalleader 鍵（預設是 '\'）加上 'c' 來執行外掛。如果您沒有設定 spec_chglog_format，外掛會詢問您在此編輯會話中使用的電子郵件地址。

每次您執行外掛時，它都會檢查變更日誌中的最後一個條目是否是今天由您寫入的。如果條目相符，它只會插入一個新的變更日誌項目，否則它會建立一個新的變更日誌條目。如果您啟用 spec_chglog_release_info，它也會檢查名稱、版本和釋出版本是否相符。如果還沒更新套件的釋出版本，這個外掛會聰明地詢問您是否應該更新。

您應該知道，您可以輕鬆地設定映射來存取任何 Vim 命令（或任何東西）。如果您不喜歡 <LocalLeader>c 的預設映射，您可以自行設定按鍵。以下程式碼行示範如何在您的 vimrc 檔案中執行此操作，將外掛映射到 <F5> 鍵：

au FileType spec map <buffer> <F5> <Plug>SpecChangelog

注意：外掛會尊重您變更預設映射的意願，並且不會設定它。

此命令只會在 spec 檔案緩衝區中新增映射。

您可以輕鬆自訂您的 spec 檔案條目的外觀。若要執行此操作，只需在您的 vimrc 檔案中設定變數 "spec_chglog_format"，如下所示：

let spec_chglog_format = "%a %b %d %Y My Name <[email protected]>"

請注意，"%a %b %d %Y" 是最常用的時間格式。如果您沒有提供格式字串，當您第一次執行 SpecChangelog 命令時，它會詢問您的電子郵件地址並為您建立 spec_chglog_format 變數。這樣，您只需要提供一次電子郵件地址。

若要探索您可以使用哪些格式選項，請查閱 strftime() 函數的手冊頁。

外掛通常會在現有的 %changelog 條目項目之後插入新的項目（請注意，這不是條目本身）。如果您設定 spec_chglog_prepend 變數：

let spec_chglog_prepend = 1

它會在現有的項目之前插入新項目。

如果您願意，外掛可以在每個變更日誌條目中自動插入釋出版本資訊。開啟此功能的一個優點是它可以控制套件中上次變更後是否已更新釋出版本。如果您沒有更新套件版本或釋出版本，它會詢問您是否應該為您更新套件釋出版本。若要開啟此功能，只需在您的 vimrc 中插入以下程式碼：

let spec_chglog_release_info = 1

那麼，您的變更日誌條目中的第一個項目會類似如下：

+ name-1.0-1cl

如果您不喜歡釋出版本更新功能，並且不希望每次偵測到舊的釋出版本時都回答「否」，您可以使用以下程式碼來停用它：

let spec_chglog_never_increase_release = 1

祝你好運！