AUR 投稿ガイドライン - 版の履歴

AshMyzk: 同期

2023-05-19T06:07:25Z

同期

← 古い版		2023年5月19日 (金) 15:07時点における版
12行目:		12行目:
	{{Related articles end}}		{{Related articles end}}

	ユーザーは [[Arch User Repository]] を使って PKGBUILD を'''シェア'''することができます。AUR にはバイナリパッケージはありませんが、他のユーザがダウンロードできる PKGBUILD をアップロードできます。これらの PKGBUILD は完全に非公式なものであり、徹底して管理されてはいないので、自己責任において使うことになります。		ユーザーは [[Arch User Repository]] を使って [[PKGBUILD]] スクリプトを'''シェア'''することができます。AUR にはバイナリパッケージはありませんが、他のユーザがダウンロードできる PKGBUILD をアップロードできます。これらの PKGBUILD は完全に非公式なものであり、徹底して管理されてはいないので、自己責任において使うことになります。

	== パッケージを投稿する ==		== パッケージを投稿する ==
26行目:		26行目:
	* 投稿する PKGBUILD は、いかなる状況であっても、'''公式''' バイナリ '''リポジトリ'''に '''すでに存在する''' アプリケーションをビルドするものであってはいけません。[https://archlinux.org/packages/ 公式パッケージデータベース]でパッケージをチェックしてください。そのパッケージの任意のバージョンが存在する場合、そのパッケージを投稿'''しないでください'''。公式のパッケージが out-of-date である場合、そのフラグを立ててください。公式のパッケージが壊れている、あるいは機能不足である場合、[https://bugs.archlinux.org/ バグレポート]を提出してください。		* 投稿する PKGBUILD は、いかなる状況であっても、'''公式''' バイナリ '''リポジトリ'''に '''すでに存在する''' アプリケーションをビルドするものであってはいけません。[https://archlinux.org/packages/ 公式パッケージデータベース]でパッケージをチェックしてください。そのパッケージの任意のバージョンが存在する場合、そのパッケージを投稿'''しないでください'''。公式のパッケージが out-of-date である場合、そのフラグを立ててください。公式のパッケージが壊れている、あるいは機能不足である場合、[https://bugs.archlinux.org/ バグレポート]を提出してください。

	:この厳格な規則の'''例外'''は、パッケージが公式のパッケージと比べて '''追加の機能''' が有効化されていたり '''パッチ''' が当てられていたりする場合のみです。そのような場合は、{{ic\|pkgname}} が、その違いを表すように異なっているべきです。例えば、サイドバーのパッチを適用した GNU screen のパッケージは {{ic\|screen-sidebar}} などと名前を付けます。さらに、公式パッケージと衝突しないようにするため {{ic\|1=~~provides~~=('screen')}} を使~~ってください~~。		:この厳格な規則の'''例外'''は、パッケージが公式のパッケージと比べて '''追加の機能''' が有効化されていたり '''パッチ''' が当てられていたりする場合のみです。そのような場合は、{{ic\|pkgname}} が、その違いを表すように異なっているべきです。例えば、サイドバーのパッチを適用した GNU screen のパッケージは {{ic\|screen-sidebar}} などと名前を付けます。さらに、公式パッケージと衝突しないようにするために {{ic\|1=conflicts=('screen')}} 配列を使う必要があります。

	* そのパッケージが'''すでに存在してないか''' '''AUR をチェックしてください'''。メンテナンスされているパッケージがあるのならば、コメントからメンテナに修正を求めることができます。パッケージがメンテナンスされておらず、かつメンテナが応答しないならば、必要に応じてそのパッケージを継承し、更新することができます。重複したパッケージを作成しないでください。		* そのパッケージが'''すでに存在してないか''' '''AUR をチェックしてください'''。メンテナンスされているパッケージがあるのならば、コメントからメンテナに修正を求めることができます。パッケージがメンテナンスされておらず、かつメンテナが応答しないならば、必要に応じてそのパッケージを継承し、更新することができます。重複したパッケージを作成しないでください。
34行目:		34行目:
	:AUR と公式リポジトリは、一般的にソフトウェアやソフトウェアに関連するコンテンツをインストールするパッケージのために存在します。該当するコンテンツとしては次のものが含まれます: 実行可能ファイル、設定ファイル、特定のソフトウェアもしくは Arch Linux ディストリビューション全体のオンライン・オフラインのドキュメント、ソフトウェアによって直接使用されるメディア。		:AUR と公式リポジトリは、一般的にソフトウェアやソフトウェアに関連するコンテンツをインストールするパッケージのために存在します。該当するコンテンツとしては次のものが含まれます: 実行可能ファイル、設定ファイル、特定のソフトウェアもしくは Arch Linux ディストリビューション全体のオンライン・オフラインのドキュメント、ソフトウェアによって直接使用されるメディア。

	* AUR の PKGBUILD で {{ic\|replaces}} を使うのはパッケージの名前を変更したいときです。例えば ''Ethereal'' から ''Wireshark'' に名前が変更されたときのようにです。'''既存のパッケージの別バージョン'''としてパッケージを作成する場合、{{ic\|conflicts}} を使ってください (他のパッケージから必要とされる場合は {{ic\|provides}} も使ってください)。{{ic\|conflicts}} と {{ic\|replaces}} は、同期後 (-Sy) に pacman が即座にパッケージを置き換えるかどうかが違います。{{ic\|conflicts}} はパッケージのインストール時にしか評価されません。		* AUR の PKGBUILD で {{ic\|replaces}} を使うのはパッケージの名前を変更したいときに限ります。例えば ''Ethereal'' から ''Wireshark'' に名前が変更されたときのようにです。'''既存のパッケージの別バージョン'''としてパッケージを作成する場合、{{ic\|conflicts}} を使ってください (他のパッケージから必要とされる場合は {{ic\|provides}} も使ってください)。{{ic\|conflicts}} と {{ic\|replaces}} は、同期後 (-Sy) に pacman が即座にパッケージを置き換えるかどうかが違います。{{ic\|conflicts}} はパッケージのインストール時にしか評価されません。

			* バージョン管理システムからビルドし、特定のバージョンに結び付かないパッケージには、(git の場合は {{ic\|-git}} といった) 適切な接尾辞を付ける必要があります。接尾辞の完全なリストは [[VCS パッケージガイドライン#パッケージの命名]] を参照してください。

	* '''ビルド済み'''の[[Wikipedia:ja:成果物\|成果物]]を使うパッケージには、ソースコードが利用可能な場合は、{{ic\|-bin}} サフィックスを付けなければなりません。この規則の例外として、[[Java パッケージガイドライン#パッケージング\|Java]] を使う場合です。AUR には、makepkg によって作成されたバイナリ tarball や、filelist が含まれているべきではありません。		* '''ビルド済み'''の[[Wikipedia:ja:成果物\|成果物]]を使うパッケージには、ソースコードが利用可能な場合は、{{ic\|-bin}} サフィックスを付けなければなりません。この規則の例外として、[[Java パッケージガイドライン#パッケージング\|Java]] を使う場合です。AUR には、makepkg によって作成されたバイナリ tarball や、filelist が含まれているべきではありません。

			* 特定のバージョンを用いてソースからビルドするパッケージには、接尾辞を用いません。

	* {{ic\|PKGBUILD}} ファイルのトップには、現在の '''メンテナ''' と以前の '''貢献者''' の情報を含む '''コメント行''' を、以下の形式に沿って追加してください。スパムから身を守るためにメールアドレスをぼかしましょう。追加/不必要な行は任意です。		* {{ic\|PKGBUILD}} ファイルのトップには、現在の '''メンテナ''' と以前の '''貢献者''' の情報を含む '''コメント行''' を、以下の形式に沿って追加してください。スパムから身を守るためにメールアドレスをぼかしましょう。追加/不必要な行は任意です。

			{{Note\|電子メールのアドレスに関して難読化を行うと人々があなたに連絡を行うことを困難にしてしまいます。}}

	:もしあなたが既存の PKGBUILD のメンテナの役割を引き受けるのであれば、以下のようにあなたの名前をトップに追加してください。		:もしあなたが既存の PKGBUILD のメンテナの役割を引き受けるのであれば、以下のようにあなたの名前をトップに追加してください。
	:{{bc\|<nowiki>		:{{bc\|<nowiki>
117行目:		124行目:
	* パッケージを投稿したらそのまま放置するのはやめてください。アップデートをチェックし、PKGBUILD を修正してパッケージをメンテナンスするのがメンテナの仕事です。		* パッケージを投稿したらそのまま放置するのはやめてください。アップデートをチェックし、PKGBUILD を修正してパッケージをメンテナンスするのがメンテナの仕事です。
	* 何らかの理由でパッケージのメンテナンスが続けられない場合は、AUR ウェブインタフェースでパッケージを {{ic\|disown}} するか、メーリングリストにメッセージを投稿してください。AUR パッケージのメンテナがパッケージを放棄すると、パッケージは[https://aur.archlinux.org/packages/?SB=n&do_Orphans=Orphans "孤児"]パッケージになります。		* 何らかの理由でパッケージのメンテナンスが続けられない場合は、AUR ウェブインタフェースでパッケージを {{ic\|disown}} するか、メーリングリストにメッセージを投稿してください。AUR パッケージのメンテナがパッケージを放棄すると、パッケージは[https://aur.archlinux.org/packages/?SB=n&do_Orphans=Orphans "孤児"]パッケージになります。
			* 自動化はメンテナにとって価値のあるツールですが、[https://lists.archlinux.org/archives/list/aur-general@lists.archlinux.org/message/AYISVT7SOB444HXHIF2CKA2TIHBESH2D/ 手動介入]を置き換えることはできません (例: プロジェクトは、たとえ「マイナー」リリースであっても、ライセンスの変更、依存関係の追加/削除、その他の重要な変更を行う可能性があります)。自動的に作成された PKGBUILD の更新は自己責任で使用してください。機能不全に陥ったアカウントやそのパッケージは予告もなく削除される場合があります。

	== リクエスト ==		== リクエスト ==

	孤児リクエスト、消去リクエスト、~~マージ~~リクエストは右側の "パッケージアクション" の下にある "リクエストを送信" リンクをクリックして作成することができます。リクエストが作成されると~~自動的に~~通知メールがパッケージの現在のメンテナと [https://lists.archlinux.org/mailman3/lists/aur-requests.lists.archlinux.org/ aur-requests メーリングリスト] に送信されます。その後 [[Trusted Users]] がリクエストの承認・却下を行います。		削除リクエスト、マージリクエスト、孤児リクエストは右側の "パッケージアクション" の下にある "リクエストを送信" リンクをクリックして作成することができます。リクエストが作成されると通知メールがパッケージの現在のメンテナと [https://lists.archlinux.org/mailman3/lists/aur-requests.lists.archlinux.org/ aur-requests メーリングリスト] に送信されます。その後 [[Trusted Users]] がリクエストの承認・却下を行います。

⚫	* 孤児リクエストは、現在のメンテナが応答しない場合、通るのに2週間~~掛かり~~ます。例外は、~~180 日間以上~~パッケージに out-of-date フラグが立てられている場合です。この場合、孤児リクエストは自動的に受理されます。
			=== 削除 ===
	* マージリクエストは、パッケージベースを削除し、票とコメントを他のパッケージベースに転送します。マージ先のパッケージベースの名前が必要です。これは 'git merge' や GitLab のマージリクエストとは関係ないことに注意してください。

	* 消去リクエストには以下の情報が必要です:
			AUR から {{ic\|''pkgbase''}} を削除するリクエストです。削除の理由とそれの裏付けとなる詳細 (他のパッケージによってパッケージが提供されている、あなた自身がメンテナである、パッケージの名称が変更された、元の所有者が同意したなど) を説明する短いノートが必要です。
⚫	** ~~削除の理由を説明する短いノート。~~パッケージ~~のコメント欄は、パッケージを~~削除する理由を説明するのに十分で~~ないことに注意してください~~。TU が行動を~~起こして~~すぐにそのような情報を入手できる場所は aur-requests メーリングリストだけ~~だから~~です。
			{{Note\|
	** 補足事項を加えて下さい。仮にあなたがメンテナならば、他のパッケージで提供されるようになった、パッケージ名を変えて元の管理者が認めた、など。
		⚫	* パッケージが削除対象である理由をコメント欄だけで説明するのは不十分です。TU がアクションを取ったときにすぐそのような情報が入手できる唯一の場所は aur-requests メーリングリストだけです。
	** パッケージが削除されたあとも、その Git リポジトリは AUR で利用可能なままです。
			* 削除リクエストが却下される可能性もあります。この場合、あなたがそのメンテナであるならば、おそらく、パッケージを放棄して他のメンテナに引き取れるようにするようアドバイスを受けるでしょう。
			* パッケージが「削除」された後も、そのパッケージの [[git]] リポジトリは[[Arch User Repository#ビルドファイルを取得する\|クローン]]できる状態のままになります。}}

			=== マージ ===

			{{ic\|''pkgbase''}} の削除を行い、その投票数とコメントを他の {{ic\|''pkgbase''}} に移動させるリクエストです。マージ先のパッケージの名前が必要です。
			{{Note\|これは 'git merge' や GitLab のマージリクエストとは関係ありません。}}

			=== 孤児 ===

		⚫	{{ic\|''pkgbase''}} を放棄させるリクエストです。現在のメンテナが応答しない場合、このリクエストは2週間後に受理されます。例外は、パッケージに out-of-date フラグが少なくとも180日間建てられている場合です。この場合、孤児リクエストは自動的に受理されます。

	{{TranslationStatus\|AUR submission guidelines\|~~2022~~-10-29\|~~754975~~}}		{{TranslationStatus\|AUR submission guidelines\|2023-05-19\|777767}}

AshMyzk: /* リクエスト */ 修正

2023-03-17T05:05:55Z

リクエスト: 修正

← 古い版		2023年3月17日 (金) 14:05時点における版
120行目:		120行目:
	== リクエスト ==		== リクエスト ==

	孤児リクエスト、消去リクエスト、マージリクエストは右側の "パッケージアクション" の下にある "リクエストを送る" リンクをクリックして作成することができます。リクエストが作成されると自動的に通知メールがパッケージの現在のメンテナと [https://lists.archlinux.org/mailman3/lists/aur-requests.lists.archlinux.org/ aur-requests メーリングリスト] に送信されます。その後 [[Trusted Users]] がリクエストの承認・却下を行います。		孤児リクエスト、消去リクエスト、マージリクエストは右側の "パッケージアクション" の下にある "リクエストを送信" リンクをクリックして作成することができます。リクエストが作成されると自動的に通知メールがパッケージの現在のメンテナと [https://lists.archlinux.org/mailman3/lists/aur-requests.lists.archlinux.org/ aur-requests メーリングリスト] に送信されます。その後 [[Trusted Users]] がリクエストの承認・却下を行います。
	* 孤児リクエストは、現在のメンテナが応答しない場合、通るのに2週間掛かります。例外は、180 日間以上パッケージに out-of-date フラグが立てられている場合です。この場合、孤児リクエストは自動的に受理されます。		* 孤児リクエストは、現在のメンテナが応答しない場合、通るのに2週間掛かります。例外は、180 日間以上パッケージに out-of-date フラグが立てられている場合です。この場合、孤児リクエストは自動的に受理されます。
	* マージリクエストは、パッケージベースを削除し、票とコメントを他のパッケージベースに転送します。マージ先のパッケージベースの名前が必要です。これは 'git merge' や GitLab のマージリクエストとは関係ないことに注意してください。		* マージリクエストは、パッケージベースを削除し、票とコメントを他のパッケージベースに転送します。マージ先のパッケージベースの名前が必要です。これは 'git merge' や GitLab のマージリクエストとは関係ないことに注意してください。

Teasoak: 誤字の修正

2023-03-16T15:43:12Z

誤字の修正

← 古い版		2023年3月17日 (金) 00:43時点における版
38行目:		38行目:
	* '''ビルド済み'''の[[Wikipedia:ja:成果物\|成果物]]を使うパッケージには、ソースコードが利用可能な場合は、{{ic\|-bin}} サフィックスを付けなければなりません。この規則の例外として、[[Java パッケージガイドライン#パッケージング\|Java]] を使う場合です。AUR には、makepkg によって作成されたバイナリ tarball や、filelist が含まれているべきではありません。		* '''ビルド済み'''の[[Wikipedia:ja:成果物\|成果物]]を使うパッケージには、ソースコードが利用可能な場合は、{{ic\|-bin}} サフィックスを付けなければなりません。この規則の例外として、[[Java パッケージガイドライン#パッケージング\|Java]] を使う場合です。AUR には、makepkg によって作成されたバイナリ tarball や、filelist が含まれているべきではありません。

	* {{ic\|PKGBUILD}} ファイルのトップには、現在の '''メンテな''' と以前の '''貢献者''' の情報を含む '''コメント行''' を、以下の形式に沿って追加してください。スパムから身を守るためにメールアドレスをぼかしましょう。追加/不必要な行は任意です。		* {{ic\|PKGBUILD}} ファイルのトップには、現在の '''メンテナ''' と以前の '''貢献者''' の情報を含む '''コメント行''' を、以下の形式に沿って追加してください。スパムから身を守るためにメールアドレスをぼかしましょう。追加/不必要な行は任意です。
	:もしあなたが既存の PKGBUILD のメンテナの役割を引き受けるのであれば、以下のようにあなたの名前をトップに追加してください。		:もしあなたが既存の PKGBUILD のメンテナの役割を引き受けるのであれば、以下のようにあなたの名前をトップに追加してください。
	:{{bc\|<nowiki>		:{{bc\|<nowiki>

AshMyzk: TranslationStatus

2022-10-29T08:04:55Z

TranslationStatus

← 古い版		2022年10月29日 (土) 17:04時点における版
127行目:		127行目:
	** 補足事項を加えて下さい。仮にあなたがメンテナならば、他のパッケージで提供されるようになった、パッケージ名を変えて元の管理者が認めた、など。		** 補足事項を加えて下さい。仮にあなたがメンテナならば、他のパッケージで提供されるようになった、パッケージ名を変えて元の管理者が認めた、など。
	** パッケージが削除されたあとも、その Git リポジトリは AUR で利用可能なままです。		** パッケージが削除されたあとも、その Git リポジトリは AUR で利用可能なままです。

			{{TranslationStatus\|AUR submission guidelines\|2022-10-29\|754975}}

AshMyzk: /* 新しいパッケージコンテンツを公開する */ 翻訳

2022-10-29T08:04:00Z

新しいパッケージコンテンツを公開する: 翻訳

← 古い版		2022年10月29日 (土) 17:04時点における版
87行目:		87行目:
	=== 新しいパッケージコンテンツを公開する ===		=== 新しいパッケージコンテンツを公開する ===

	{{Warning\|~~Your commits will be authored with your~~ [[Git#~~Configuration~~\|~~global~~ Git ~~name and~~ email ~~address~~]]~~. It is very difficult to change commits after pushing~~ ~~them~~ ({{Bug\|45425}}). If ~~you want to~~ push ~~to the AUR under different credentials, you can change them per package with~~ {{ic\|git config user.name "..."}} ~~and~~ {{ic\|git config user.email "..."}}.}}		{{Warning\|あなたのコミットは、あなたの[[Git#設定\|グローバルな Git の名前と email アドレス]]によって認証されます。コミットを、push した後に変更するのは非常に困難です ({{Bug\|45425}})。別の認証情報を使って AUR に push したい場合、パッケージごとに {{ic\|git config user.name "..."}} と {{ic\|git config user.email "..."}} を使って認証情報を変更することができます。}}

			パッケージングされたソフトウェアの新しいバージョンをリリースする際は、[[pkgver]] 変数か [[PKGBUILD#pkgrel\|pkgrel]] 変数を更新して、すべてのユーザにアップグレードが必要であることを通知してください。typo の修正など、[[PKGBUILD]] のマイナーな変更だけの場合は、これらの値を更新しないでください。
	When releasing a new version of the packaged software, update the [[pkgver]] or [[PKGBUILD#pkgrel\|pkgrel]] variables to notify all users that an upgrade is needed. Do not update those values if only minor changes to the [[PKGBUILD]] such as the correction of a typo are being published.

			[[VCS パッケージガイドライン\|VSC パッケージ]]の単なる {{ic\|pkgver}} バージョンアップはコミットしないでください。それらは、上流に新しいコミットがある場合に、out-of-date とみなされません。新しいコミットをするのは、他の変更 (ビルドプロセスの変更など) が発生した場合に限ります。
	Do not commit mere {{ic\|pkgver}} bumps for [[VCS package guidelines\|VCS packages]]. They are not considered out of date when the upstream has new commits. Only do a new commit when other changes are introduced, such as changing the build process.

			{{ic\|PKGBUILD}} メタデータが変更された際 ({{ic\|pkgver()}} が更新されたときなど) は必ず [[.SRCINFO]] を再生成してください。さもないと、AUR は更新後のバージョン番号を表示しません。
	Be sure to regenerate [[.SRCINFO]] whenever {{ic\|PKGBUILD}} metadata changes, such as {{ic\|pkgver()}} updates; otherwise the AUR will not show updated version numbers.

			パッケージをアップロード/アップデートするには、''少なくとも'' {{ic\|PKGBUILD}} と {{ic\|.SRCINFO}} を、次に追加の新しい/変更された補助ファイル ([[PKGBUILD#install\|''.install'']] ファイルや、[[パッケージにパッチを適用\|パッチ]]などの[[PKGBUILD#source\|ローカルのソースファイル]]) [[Git#ステージング\|追加]]してください。そして、意味のあるコミットメッセージを付けて[[Git#変更をコミット\|コミット]]し、最後に変更を AUR に[[Git#リポジトリにプッシュ\|プッシュ]]してください。
	To upload or update a package, [[Git#Staging changes\|add]] ''at least'' {{ic\|PKGBUILD}} and {{ic\|.SRCINFO}}, then any additional new or modified helper files (such as [[PKGBUILD#install\|''.install'']] files or [[PKGBUILD#source\|local source files]] such as [[Patching packages\|patches]]), [[Git#Committing changes\|commit]] with a meaningful commit message, and finally [[Git#Push to a repository\|push]] the changes to the AUR.

			例:
	For example:

	$ makepkg --printsrcinfo > .SRCINFO		$ makepkg --printsrcinfo > .SRCINFO
105行目:		105行目:

	{{Note\|		{{Note\|
	* If {{ic\|.SRCINFO}} ~~was not included in your first commit, add it by~~ [https://git-scm.com/docs/git-rebase#git-rebase---root ~~rebasing with~~ --root] or [https://git-scm.com/docs/git-filter-branch#git-filter-branch---tree-filterltcommandgt ~~filtering the tree~~] ~~so the~~ AUR ~~will permit your initial push.~~		* {{ic\|.SRCINFO}} が最初のコミットに含まれていなかった場合、[https://git-scm.com/docs/git-rebase#git-rebase---root --root で rebase する]か[https://git-scm.com/docs/git-filter-branch#git-filter-branch---tree-filterltcommandgt ツリーをフィルタリング]して追加してください。そうすれば、AUR は初期のプッシュを受け入れます。
	* ~~The~~ AUR ~~only allows pushes to the~~ {{ic\|master}} ~~branch. If the local branch is named something else,~~ [https://git-scm.com/docs/git-branch ~~rename it~~] ~~and push again.~~		* AUR は、{{ic\|master}} ブランチへのプッシュのみを許可します。ローカルのブランチに他の名前をつけている場合、[https://git-scm.com/docs/git-branch 名前を変更し]、再びプッシュしてください。
	}}		}}

			{{Tip\|作業ディレクトリとコミットもを可能な限り綺麗に保つには、すべてのファイルを除外する {{man\|5\|gitignore}} を作成し、必要に応じてファイルを force-add してください。}}
	{{Tip\|To keep the working directory and commits as clean as possible, create a {{man\|5\|gitignore}} that excludes all files and force-add files as needed.}}

	== パッケージをメンテナンスする ==		== パッケージをメンテナンスする ==

AshMyzk: /* パッケージのリポジトリを作成する */ 修正

2022-10-29T06:13:24Z

パッケージのリポジトリを作成する: 修正

← 古い版		2022年10月29日 (土) 15:13時点における版
81行目:		81行目:
	$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git		$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git

	次に、~~AUR 内に~~このリモートリポジトリを[[Git#リモートの使用\|フェッチ]]して初期化してください。		次に、このリモートリポジトリを[[Git#リモートの使用\|フェッチ]]して初期化してください。

	{{Note\|{{ic\|''pkgbase''}} が削除されたパッケージとマッチする場合、衝突を解決するために [https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive pull、rebase] してください。}}		{{Note\|{{ic\|''pkgbase''}} が削除されたパッケージとマッチする場合、衝突を解決するために [https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive pull、rebase] してください。}}

AshMyzk: /* パッケージのリポジトリを作成する */ 修正

2022-10-29T06:04:54Z

パッケージのリポジトリを作成する: 修正

← 古い版		2022年10月29日 (土) 15:04時点における版
81行目:		81行目:
	$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git		$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git

	次に、AUR 内にこのリモートを[[Git#リモートの使用\|フェッチ]]して初期化してください。		次に、AUR 内にこのリモートリポジトリを[[Git#リモートの使用\|フェッチ]]して初期化してください。

	{{Note\|{{ic\|''pkgbase''}} が削除されたパッケージとマッチする場合、衝突を解決するために [https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive pull、rebase] してください。}}		{{Note\|{{ic\|''pkgbase''}} が削除されたパッケージとマッチする場合、衝突を解決するために [https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive pull、rebase] してください。}}

AshMyzk: /* パッケージのリポジトリを作成する */ 修正

2022-10-29T06:02:59Z

パッケージのリポジトリを作成する: 修正

← 古い版		2022年10月29日 (土) 15:02時点における版
83行目:		83行目:
	次に、AUR 内にこのリモートを[[Git#リモートの使用\|フェッチ]]して初期化してください。		次に、AUR 内にこのリモートを[[Git#リモートの使用\|フェッチ]]して初期化してください。

	{{Note\|{{ic\|''pkgbase''}} が削除されたパッケージとマッチする場合、衝突を解決するために [https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive ~~Pull~~、rebase] してください。}}		{{Note\|{{ic\|''pkgbase''}} が削除されたパッケージとマッチする場合、衝突を解決するために [https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive pull、rebase] してください。}}

	=== 新しいパッケージコンテンツを公開する ===		=== 新しいパッケージコンテンツを公開する ===

AshMyzk: /* パッケージのリポジトリを作成する */ 修正

2022-10-29T06:01:54Z

パッケージのリポジトリを作成する: 修正

← 古い版		2022年10月29日 (土) 15:01時点における版
68行目:		68行目:
	=== パッケージのリポジトリを作成する ===		=== パッケージのリポジトリを作成する ===

	ゼロから[[パッケージの作成\|新しいパッケージを作成]]しているのであれば、目的の [[PKGBUILD#pkgbase\|pkgbase]] を[[Git\|クローン]]して、ローカルの Git リポジトリと AUR リモートを作る必要があります。パッケージがまだ存在しない場合、以下の警告が表示されるでしょう:		ゼロから[[パッケージの作成\|新しいパッケージを作成]]しているのであれば、目的の [[PKGBUILD#pkgbase\|pkgbase]] を[[Git\|クローン]]して、ローカルの Git リポジトリと AUR リモートリポジトリを作る必要があります。パッケージがまだ存在しない場合、以下の警告が表示されるでしょう:

	{{hc\|$ git clone <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git\|		{{hc\|$ git clone <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git\|
77行目:		77行目:
	{{Note\|{{ic\|''pkgbase''}} が[[#リクエスト\|削除された]]パッケージとマッチする場合、リポジトリは空にはなりません。}}		{{Note\|{{ic\|''pkgbase''}} が[[#リクエスト\|削除された]]パッケージとマッチする場合、リポジトリは空にはなりません。}}

	すでにパッケージを持っている場合、それが Git リポジトリでないならば、Git リポジトリとして[[Git\|初期化]]してください。そして AUR リモートを追加してください:		すでにパッケージを持っている場合、それが Git リポジトリでないならば、Git リポジトリとして[[Git\|初期化]]してください。そして AUR リモートリポジトリを追加してください:

	$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git		$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git

AshMyzk: /* パッケージのリポジトリを作成する */ 翻訳

2022-10-29T05:14:39Z

パッケージのリポジトリを作成する: 翻訳

← 古い版		2022年10月29日 (土) 14:14時点における版
68行目:		68行目:
	=== パッケージのリポジトリを作成する ===		=== パッケージのリポジトリを作成する ===

			ゼロから[[パッケージの作成\|新しいパッケージを作成]]しているのであれば、目的の [[PKGBUILD#pkgbase\|pkgbase]] を[[Git\|クローン]]して、ローカルの Git リポジトリと AUR リモートを作る必要があります。パッケージがまだ存在しない場合、以下の警告が表示されるでしょう:
	If you are [[Creating packages\|creating a new package]] from scratch, establish a local Git repository and an AUR remote by [[Git#Getting a Git repository\|cloning]] the intended [[PKGBUILD#pkgbase\|pkgbase]]. If the package does not yet exist, the following warning is expected:

	{{hc\|$ git clone <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git\|		{{hc\|$ git clone <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git\|
75行目:		75行目:
	Checking connectivity... done.}}		Checking connectivity... done.}}

			{{Note\|{{ic\|''pkgbase''}} が[[#リクエスト\|削除された]]パッケージとマッチする場合、リポジトリは空にはなりません。}}
	{{Note\|The repository will not be empty if {{ic\|''pkgbase''}} matches a [[#Requests\|deleted]] package.}}

			すでにパッケージを持っている場合、それが Git リポジトリでないならば、Git リポジトリとして[[Git\|初期化]]してください。そして AUR リモートを追加してください:
	If you already have a package, [[Git#Getting a Git repository\|initialize it]] as a Git repository if it is not one, and add an AUR remote:

	$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git		$ git remote add ''label'' <nowiki>ssh://</nowiki>aur@aur.archlinux.org/''pkgbase''.git

			次に、AUR 内にこのリモートを[[Git#リモートの使用\|フェッチ]]して初期化してください。
	Then [[Git#Using remotes\|fetch]] this remote to initialize it in the AUR.

	{{Note\|[https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive Pull ~~and~~ rebase] ~~to resolve conflicts if {{ic\|''pkgbase''}} matches a deleted package.~~}}		{{Note\|{{ic\|''pkgbase''}} が削除されたパッケージとマッチする場合、衝突を解決するために [https://git-scm.com/docs/git-pull#git-pull---rebasefalsetruemergespreserveinteractive Pull、rebase] してください。}}

	=== 新しいパッケージコンテンツを公開する ===		=== 新しいパッケージコンテンツを公開する ===

← 古い版		2022年10月29日 (土) 17:04時点における版
87行目:		87行目:
	=== 新しいパッケージコンテンツを公開する ===		=== 新しいパッケージコンテンツを公開する ===

	{{Warning\|~~Your commits will be authored with your~~ [[Git#~~Configuration~~\|~~global~~ Git ~~name and~~ email ~~address~~]]~~. It is very difficult to change commits after pushing~~ ~~them~~ ({{Bug\|45425}}). If ~~you want to~~ push ~~to the AUR under different credentials, you can change them per package with~~ {{ic\|git config user.name "..."}} ~~and~~ {{ic\|git config user.email "..."}}.}}		{{Warning\|あなたのコミットは、あなたの[[Git#設定\|グローバルな Git の名前と email アドレス]]によって認証されます。コミットを、push した後に変更するのは非常に困難です ({{Bug\|45425}})。別の認証情報を使って AUR に push したい場合、パッケージごとに {{ic\|git config user.name "..."}} と {{ic\|git config user.email "..."}} を使って認証情報を変更することができます。}}

			パッケージングされたソフトウェアの新しいバージョンをリリースする際は、[[pkgver]] 変数か [[PKGBUILD#pkgrel\|pkgrel]] 変数を更新して、すべてのユーザにアップグレードが必要であることを通知してください。typo の修正など、[[PKGBUILD]] のマイナーな変更だけの場合は、これらの値を更新しないでください。
	When releasing a new version of the packaged software, update the [[pkgver]] or [[PKGBUILD#pkgrel\|pkgrel]] variables to notify all users that an upgrade is needed. Do not update those values if only minor changes to the [[PKGBUILD]] such as the correction of a typo are being published.

			[[VCS パッケージガイドライン\|VSC パッケージ]]の単なる {{ic\|pkgver}} バージョンアップはコミットしないでください。それらは、上流に新しいコミットがある場合に、out-of-date とみなされません。新しいコミットをするのは、他の変更 (ビルドプロセスの変更など) が発生した場合に限ります。
	Do not commit mere {{ic\|pkgver}} bumps for [[VCS package guidelines\|VCS packages]]. They are not considered out of date when the upstream has new commits. Only do a new commit when other changes are introduced, such as changing the build process.

			{{ic\|PKGBUILD}} メタデータが変更された際 ({{ic\|pkgver()}} が更新されたときなど) は必ず [[.SRCINFO]] を再生成してください。さもないと、AUR は更新後のバージョン番号を表示しません。
	Be sure to regenerate [[.SRCINFO]] whenever {{ic\|PKGBUILD}} metadata changes, such as {{ic\|pkgver()}} updates; otherwise the AUR will not show updated version numbers.

			パッケージをアップロード/アップデートするには、''少なくとも'' {{ic\|PKGBUILD}} と {{ic\|.SRCINFO}} を、次に追加の新しい/変更された補助ファイル ([[PKGBUILD#install\|''.install'']] ファイルや、[[パッケージにパッチを適用\|パッチ]]などの[[PKGBUILD#source\|ローカルのソースファイル]]) [[Git#ステージング\|追加]]してください。そして、意味のあるコミットメッセージを付けて[[Git#変更をコミット\|コミット]]し、最後に変更を AUR に[[Git#リポジトリにプッシュ\|プッシュ]]してください。
	To upload or update a package, [[Git#Staging changes\|add]] ''at least'' {{ic\|PKGBUILD}} and {{ic\|.SRCINFO}}, then any additional new or modified helper files (such as [[PKGBUILD#install\|''.install'']] files or [[PKGBUILD#source\|local source files]] such as [[Patching packages\|patches]]), [[Git#Committing changes\|commit]] with a meaningful commit message, and finally [[Git#Push to a repository\|push]] the changes to the AUR.

			例:
	For example:

	$ makepkg --printsrcinfo > .SRCINFO		$ makepkg --printsrcinfo > .SRCINFO
105行目:		105行目:

	{{Note\|		{{Note\|
	* If {{ic\|.SRCINFO}} ~~was not included in your first commit, add it by~~ [https://git-scm.com/docs/git-rebase#git-rebase---root ~~rebasing with~~ --root] or [https://git-scm.com/docs/git-filter-branch#git-filter-branch---tree-filterltcommandgt ~~filtering the tree~~] ~~so the~~ AUR ~~will permit your initial push.~~		* {{ic\|.SRCINFO}} が最初のコミットに含まれていなかった場合、[https://git-scm.com/docs/git-rebase#git-rebase---root --root で rebase する]か[https://git-scm.com/docs/git-filter-branch#git-filter-branch---tree-filterltcommandgt ツリーをフィルタリング]して追加してください。そうすれば、AUR は初期のプッシュを受け入れます。
	* ~~The~~ AUR ~~only allows pushes to the~~ {{ic\|master}} ~~branch. If the local branch is named something else,~~ [https://git-scm.com/docs/git-branch ~~rename it~~] ~~and push again.~~		* AUR は、{{ic\|master}} ブランチへのプッシュのみを許可します。ローカルのブランチに他の名前をつけている場合、[https://git-scm.com/docs/git-branch 名前を変更し]、再びプッシュしてください。
	}}		}}

			{{Tip\|作業ディレクトリとコミットもを可能な限り綺麗に保つには、すべてのファイルを除外する {{man\|5\|gitignore}} を作成し、必要に応じてファイルを force-add してください。}}
	{{Tip\|To keep the working directory and commits as clean as possible, create a {{man\|5\|gitignore}} that excludes all files and force-add files as needed.}}

	== パッケージをメンテナンスする ==		== パッケージをメンテナンスする ==