Minilla-v2.1.1 >
modules/Minilla-v0.11.0
との差分
Minilla modules/Minilla-v0.11.0 と modules/Minilla-v2.1.1 の差分
1 | 1 | =encoding utf8 |
2 | 2 | |
3 | 3 | =for stopwords MINILLA .mailmap mimick XSUtil travis XSUtil.needs_compiler_cpp XSUtil.generate_xshelper_h XSUtil.cc_warnings DarkPAN |
4 | 4 | |
5 | 5 | =head1 NAME |
6 | 6 | |
7 | 7 | =begin original |
8 | 8 | |
9 | 9 | Minilla - CPAN module authoring tool |
10 | 10 | |
11 | 11 | =end original |
12 | 12 | |
13 | 13 | Minilla - CPAN モジュールオーサリングツール |
14 | 14 | |
15 | 15 | =head1 SYNOPSIS |
16 | 16 | |
17 | 17 | =begin original |
18 | 18 | |
19 | 19 | minil new - Create a new dist |
20 | 20 | minil test - Run test cases |
21 | 21 | minil dist - Make your dist tarball |
22 | 22 | minil install - Install your dist |
23 | 23 | minil release - Release your dist to CPAN |
24 | 24 | minil run - Run arbitrary commands against build dir |
25 | 25 | |
26 | 26 | =end original |
27 | 27 | |
28 | 28 | minil new - 新しいディストリビューションを作る |
29 | 29 | minil test - テストケースを実行する |
30 | 30 | minil dist - 配布用のtar玉を作る |
31 | 31 | minil install - ディストリビューションをインストールする |
32 | 32 | minil release - ディストリビューションをCPANにリリースする |
33 | 33 | minil run - ビルドディレクトリに対して任意のコマンドを実行する |
34 | 34 | |
35 | 35 | =head1 DESCRIPTION |
36 | 36 | |
37 | 37 | =begin original |
38 | 38 | |
39 | 39 | Minilla is a CPAN module authoring tool. Minilla provides L<minil> command for authorizing a CPAN distribution. |
40 | 40 | |
41 | 41 | =end original |
42 | 42 | |
43 | 43 | Minilla は CPANモジュールのオーサリングツールです。Minillaは CPANディストリビューションのオーサリングのために、L<minil>コマンドを用意します。 |
44 | 44 | |
45 | 45 | (M::I - inc) + shipit + (dzil - plugins) |
46 | 46 | |
47 | 47 | =begin original |
48 | 48 | |
49 | 49 | B<THIS IS A DEVELOPMENT RELEASE. API MAY CHANGE WITHOUT NOTICE>. |
50 | 50 | |
51 | 51 | =end original |
52 | 52 | |
53 | 53 | B<これは、開発版リリースです。APIは予告なしに変更されるかもしれません> |
54 | 54 | |
55 | 55 | =head1 MOTIVATION |
56 | 56 | |
57 | 57 | (動機) |
58 | 58 | |
59 | 59 | =head1 CONVENTION |
60 | 60 | |
61 | 61 | (慣習) |
62 | 62 | |
63 | 63 | =begin original |
64 | 64 | |
65 | 65 | As stated above, Minilla is opinionated. Minilla has a bold assumption and convention like the followings, which are almost compatible to the sister project L<Dist::Milla>. |
66 | 66 | |
67 | 67 | =end original |
68 | 68 | |
69 | 69 | 以上のように、Minilla は独断的です。Minillaには以下のような大胆な仮説と慣習があります。これらは姉妹プロジェクトのL<Dist::Milla>とほとんど互換性があります。 |
70 | 70 | |
71 | 71 | =begin original |
72 | 72 | |
73 | 73 | =over 4 |
74 | 74 | |
75 | 75 | =item Your module written in Pure Perl are located in I<lib/>. |
76 | 76 | |
77 | 77 | =item Your executable file is in I<script/> directory, if any |
78 | 78 | |
79 | 79 | =item Your module is maintained with B<Git> and C<git ls-files> matches with what you will release |
80 | 80 | |
81 | 81 | =item Your module has a static list of prerequisites that can be described in L<cpanfile> |
82 | 82 | |
83 | 83 | =item Your module has a Changes file |
84 | 84 | |
85 | 85 | =back |
86 | 86 | |
87 | 87 | =end original |
88 | 88 | |
89 | 89 | =over 4 |
90 | 90 | |
91 | 91 | =item I<lib/>以下にPure Perl でモジュールが書かれている |
92 | 92 | |
93 | 93 | =item 実行ファイルはなんであれ、I<script/>ディレクトリ以下にある |
94 | 94 | |
95 | 95 | =item モジュールは B<Git> でメンテナンスされており、C<git ls-files> は、リリースするものにマッチする |
96 | 96 | |
97 | 97 | =item モジュールは、L<cpanfile>に予め必要なものの静的なリストがある |
98 | 98 | |
99 | 99 | =item モジュールには、Changes がある |
100 | 100 | |
101 | 101 | =back |
102 | 102 | |
103 | 103 | =head1 GETTING STARTED |
104 | 104 | |
105 | 105 | (始めましょう) |
106 | 106 | |
107 | 107 | # First time only |
108 | 108 | % cpanm Minilla |
109 | 109 | # Minilla has only a few deps. It should be very quick |
110 | 110 | |
111 | 111 | # Make a new distribution |
112 | 112 | % minil new Dist-Name |
113 | 113 | % cd Dist-Name/ |
114 | 114 | |
115 | 115 | # Git commit |
116 | 116 | % git commit -m "initial commit" |
117 | 117 | |
118 | 118 | # Hack your code! |
119 | 119 | % $EDITOR lib/Dist/Name.pm t/dist-name.t cpanfile |
120 | 120 | |
121 | 121 | # Done? Test and release it! |
122 | 122 | % minil release |
123 | 123 | |
124 | 124 | =begin original |
125 | 125 | |
126 | 126 | It's that easy. |
127 | 127 | |
128 | 128 | =end original |
129 | 129 | |
130 | 130 | このように、簡単です。 |
131 | 131 | |
132 | 132 | =begin original |
133 | 133 | |
134 | 134 | You already have distributions with L<Module::Install>, L<Module::Build>, L<Dist::Zilla> or L<ShipIt>? Migrating is also trivial. See "MIGRATING" in L<Minilla::Tutorial> for more details. |
135 | 135 | |
136 | 136 | =end original |
137 | 137 | |
138 | 138 | L<Module::Install>、L<Module::Build>、L<Dist::Zilla>、または、L<ShipIt>を使ったディストリビューションがすでにありますか? 移行もまた些細なことです。詳細は、L<Minilla::Tutorial>の"MIGRATING"を見てください。 |
139 | 139 | |
140 | 140 | =head1 WHY MINILLA? |
141 | 141 | |
142 | 142 | (なぜ MINILLA?) |
143 | 143 | |
144 | 144 | =head2 Repository managed by Minilla is git install ready. |
145 | 145 | |
146 | 146 | (Minillaで作成され、管理されたリポジトリは git インストールできます。) |
147 | 147 | |
148 | 148 | =begin original |
149 | 149 | |
150 | 150 | The repository created and managed by Minilla is git install ready. |
151 | 151 | You can install the library by C<< cpanm git://... >>. |
152 | 152 | |
153 | 153 | =end original |
154 | 154 | |
155 | 155 | Minillaで作成され、管理されたリポジトリは git インストールできます。 |
156 | 156 | C<< cpanm git://... >>で、インストールできます。 |
157 | 157 | |
158 | 158 | =begin original |
159 | 159 | |
160 | 160 | Of course, you can install Minilla from C<< cpanm git://github.com/tokuhirom/Minilla.git >>. |
161 | 161 | |
162 | 162 | =end original |
163 | 163 | |
164 | 164 | もちろん、Minilla を、 C<< cpanm git://github.com/tokuhirom/Minilla.git >> からインストールできます。 |
165 | 165 | |
166 | 166 | =head2 Minilla is built on small libraries. |
167 | 167 | |
168 | 168 | (Minilla は小さなライブラリでできています。) |
169 | 169 | |
170 | 170 | =begin original |
171 | 171 | |
172 | 172 | Minilla is built on only few small libraries. You can install Minilla without a huge list of dependencies to heavy modules. |
173 | 173 | |
174 | 174 | =end original |
175 | 175 | |
176 | 176 | Minilla は、ほんの少しの小さなライブラリで作られています。重たいモジュールに依存する巨大なリストなしに、インストールすることができます。 |
177 | 177 | |
178 | 178 | =head2 And, what is Minilla? |
179 | 179 | |
180 | 180 | (Minillaって何?) |
181 | 181 | |
182 | 182 | =begin original |
183 | 183 | |
184 | 184 | Minilla is a Kaiju (Japanese giant monster) from the Godzilla series of films and is the first of several young Godzillas. |
185 | 185 | http://en.wikipedia.org/wiki/Minilla |
186 | 186 | |
187 | 187 | =end original |
188 | 188 | |
189 | 189 | ミニラは怪獣(日本の巨大なモンスター)で、ゴジラの一連の映画から取られました。最初の若いゴジラです。 |
190 | 190 | http://en.wikipedia.org/wiki/Minilla |
191 | 191 | |
192 | 192 | =head1 CONFIGURATION |
193 | 193 | |
194 | 194 | (設定) |
195 | 195 | |
196 | 196 | =begin original |
197 | 197 | |
198 | 198 | Minilla uses B<Convention over Configuration>. |
199 | 199 | |
200 | 200 | =end original |
201 | 201 | |
202 | 202 | Minilla は B<設定より規約>を用いています。 |
203 | 203 | |
204 | 204 | =begin original |
205 | 205 | |
206 | 206 | But, you can write configurations to I<minil.toml> file in L<TOML|https://github.com/mojombo/toml> format. Minilla reads the I<minil.toml> file in the root directory of your project. |
207 | 207 | |
208 | 208 | =end original |
209 | 209 | |
210 | 210 | ですが、設定をI<minil.toml>ファイルに L<TOML|https://github.com/mojombo/toml>フォーマットで書くことができます。Minilla は、プロジェクトのルートディレクトリにあるI<minil.toml>ファイルを読みます。 |
211 | 211 | |
212 | 212 | =over 4 |
213 | 213 | |
214 | 214 | =item name |
215 | 215 | |
216 | 216 | =begin original |
217 | 217 | |
218 | 218 | You can write 'name' instead of automatically detecting project name out of the directory name. |
219 | 219 | |
220 | 220 | =end original |
221 | 221 | |
222 | 222 | ディレクトリ名から自動的に調べられるプロジェクト名の代わりに、'name'を書くことができます。 |
223 | 223 | |
224 | 224 | =item readme_from |
225 | 225 | |
226 | 226 | readme_from="lib/My/Foo.pod" |
227 | 227 | |
228 | 228 | =begin original |
229 | 229 | |
230 | 230 | You can specify the file to generate the README.md. This is a main module path by default. |
231 | 231 | |
232 | 232 | =end original |
233 | 233 | |
234 | 234 | README.md を生成するファイルを指定することができます。デフォルトではメインのモジュールのパスです。 |
235 | 235 | |
236 | 236 | =item tag_format |
237 | 237 | |
238 | 238 | tag_format="perl/%v" |
239 | 239 | |
240 | 240 | =begin original |
241 | 241 | |
242 | 242 | format of the tag to apply. Defaults to %v. C<%v> will replace with the distribution version. |
243 | 243 | |
244 | 244 | =end original |
245 | 245 | |
246 | 246 | 適用するタグのフォーマットです。デフォルトは %v です。C<%v> はディストリビューションのバージョンに置換されます。 |
247 | 247 | |
248 | 248 | =item abstract_from |
249 | 249 | |
250 | 250 | abstract_from="lib/My/Foo.pod" |
251 | 251 | |
252 | 252 | =begin original |
253 | 253 | |
254 | 254 | Grab abstract information from the file contains pod. |
255 | 255 | |
256 | 256 | =end original |
257 | 257 | |
258 | 258 | アブストラクトの情報をpodが書かれているファイルから取り出します。 |
259 | 259 | |
260 | 260 | =item authors_from |
261 | 261 | |
262 | 262 | authors_from="lib/My/Foo.pod" |
263 | 263 | |
264 | 264 | =begin original |
265 | 265 | |
266 | 266 | Grab authors information from the file contains pod. |
267 | 267 | |
268 | 268 | =end original |
269 | 269 | |
270 | 270 | 著者の情報をpodが書かれているファイルから取り出します。 |
271 | 271 | |
272 | 272 | =item authority |
273 | 273 | |
274 | 274 | authority = "cpan:TOKUHIROM" |
275 | 275 | |
276 | 276 | =begin original |
277 | 277 | |
278 | 278 | Set x_authority attribute to META. |
279 | 279 | See L<http://jawnsy.wordpress.com/2011/02/20/what-is-x_authority/> for more details. |
280 | 280 | |
281 | 281 | =end original |
282 | 282 | |
283 | 283 | METAに x_authority 属性を設定します。 |
284 | 284 | 詳細は、L<http://jawnsy.wordpress.com/2011/02/20/what-is-x_authority/>を見てください。 |
285 | 285 | |
286 | 286 | =item allow_pureperl |
287 | 287 | |
288 | 288 | allow_pureperl=1 |
289 | 289 | |
290 | 290 | =begin original |
291 | 291 | |
292 | 292 | A boolean indicating the module is still functional without its XS parts. When an XS module is build |
293 | 293 | with C<--pureperl_only>, it will otherwise fail. |
294 | 294 | |
295 | 295 | =end original |
296 | 296 | |
297 | 297 | XSの部分がなくても、モジュールが機能的であることを示す真偽値です。XSモジュールが |
298 | 298 | C<--pureperl_only>でビルドされる時に、真でなければ失敗します。 |
299 | 299 | |
300 | 300 | =begin original |
301 | 301 | |
302 | 302 | It affects to L<Module::Build> 0.4005+ only. |
303 | 303 | |
304 | 304 | =end original |
305 | 305 | |
306 | 306 | L<Module::Build> 0.4005以上のバージョンでのみ有効です。 |
307 | 307 | |
308 | 308 | =item no_github_issues |
309 | 309 | |
310 | 310 | no_github_issues=true |
311 | 311 | |
312 | 312 | =begin original |
313 | 313 | |
314 | 314 | Minilla sets bugtracker as github issues by default. But if you want to use RT, you can set this variable. |
315 | 315 | |
316 | 316 | =end original |
317 | 317 | |
318 | 318 | Minilla はデフォルトで github の issues をバグトラッカーとして設定します。RTを使いたければ、この値を設定することができます。 |
319 | 319 | |
320 | 320 | =item no_index |
321 | 321 | |
322 | 322 | [no_index] |
323 | 323 | directory=['t', 'xt', 'tools'] |
324 | 324 | |
325 | 325 | =begin original |
326 | 326 | |
327 | 327 | Minilla sets META.json's no_index as C<< directory => ['t', 'xt', 'inc', 'share', 'eg', 'examples', 'author', 'builder'] >> |
328 | 328 | by default. But if you want to change them, you can set this section variable. If this section is set, |
329 | 329 | specified variables are only used, in fact default settings are not merged. |
330 | 330 | |
331 | 331 | =end original |
332 | 332 | |
333 | 333 | Minilla はデフォルトで META.jsonの no_index を C<< directory => ['t', 'xt', 'inc', 'share', 'eg', 'examples', 'author', 'builder'] >>として |
334 | 334 | 設定します。ですが、これらを変更したければ、このセクションの値をセットできます。このセクションが設定された場合、 |
335 | 335 | 指定された値のみが使われます。実際に、デフォルトの設定はマージされません。 |
336 | 336 | |
337 | 337 | =item c_source |
338 | 338 | |
339 | 339 | c_source = ['src'] |
340 | 340 | |
341 | 341 | =begin original |
342 | 342 | |
343 | 343 | A directory which contains C source files that the rest of the build may depend |
344 | 344 | on. Any ".c" files in the directory will be compiled to object files. |
345 | 345 | The directory will be added to the search path during the compilation and |
346 | 346 | linking phases of any C or XS files. |
347 | 347 | |
348 | 348 | =end original |
349 | 349 | |
350 | 350 | 残りのビルドが依存している C のソースファイルのあるディレクトリ。 |
351 | 351 | ディレクトリにある、すべての ".c" ファイルはオブジェクトファイルにコンパイルされます。 |
352 | 352 | ディレクトリは C や XS ファイルのコンパイルとリンクの間、サーチパスに加えれられます。 |
353 | 353 | |
354 | 354 | =item script_files |
355 | 355 | |
356 | 356 | script_files = ['bin/foo', 'script/*'] |
357 | 357 | |
358 | 358 | =begin original |
359 | 359 | |
360 | 360 | Minilla sets install script files as C<< ['script/*', 'bin/*'] >> by default. |
361 | 361 | |
362 | 362 | =end original |
363 | 363 | |
364 | 364 | Minilla はデフォルトで、インストールスクリプトファイルを C<< ['script/*', 'bin/*'] >> とします。 |
365 | 365 | |
366 | 366 | =item tap_harness_args(EXPERIMENTAL) |
367 | 367 | |
368 | 368 | [tap_harness_args] |
369 | 369 | jobs=19 |
370 | 370 | |
371 | 371 | =begin original |
372 | 372 | |
373 | 373 | This parameters pass to TAP::Harness when running tests. See the L<TAP::Harness> documentation for details. |
374 | 374 | |
375 | 375 | =end original |
376 | 376 | |
377 | 377 | このパラメータは、テスト時に TAP::Harness に渡されます。詳細は、L<TAP::Harness> のドキュメントを見てください。 |
378 | 378 | |
379 | 379 | =item license |
380 | 380 | |
381 | 381 | license="artistic_2" |
382 | 382 | |
383 | 383 | =begin original |
384 | 384 | |
385 | 385 | You can specify your favorite license on minil.toml. The license key is same as CPAN Meta spec 2.0. |
386 | 386 | See L<CPAN::Meta::Spec>. |
387 | 387 | |
388 | 388 | =end original |
389 | 389 | |
390 | 390 | 自分の気に入ったライセンスを minil.toml に指定できます。ライセンスのキーは CPAN Meta spec 2.0 と同じです。 |
391 | 391 | |
392 | 392 | =item badges |
393 | 393 | |
394 | 394 | badges = ['travis', 'coveralls'] |
395 | 395 | |
396 | 396 | =begin original |
397 | 397 | |
398 | 398 | Embed badges image (e.g. Travis-CI) to README.md. It ought to be array and each elements must be service name. Now, supported services are only 'travis' and 'coveralls'. |
399 | 399 | |
400 | 400 | =end original |
401 | 401 | |
402 | 402 | バッジイメージ(例. Travis-CI)を README.md に埋め込みます。配列であるべきであり、それぞれの要素はサービス名でなければいけません。現在サポートされているサービスは、'travis' と 'coveralls' のみです。 |
403 | 403 | |
404 | 404 | =item PL_files |
405 | 405 | |
406 | 406 | =begin original |
407 | 407 | |
408 | 408 | Specify the PL files. |
409 | 409 | |
410 | 410 | =end original |
411 | 411 | |
412 | 412 | PL ファイルを指定します。 |
413 | 413 | |
414 | 414 | [PL_files] |
415 | 415 | lib/Foo/Bar.pm.PL="lib/Foo/Bar.pm" |
416 | 416 | |
417 | 417 | =item build.build_class |
418 | 418 | |
419 | 419 | =begin original |
420 | 420 | |
421 | 421 | Specify a custom Module::Build subclass. |
422 | 422 | |
423 | 423 | =end original |
424 | 424 | |
425 | 425 | カスタムの Module::Build サブクラスを指定します。 |
426 | 426 | |
427 | 427 | [build] |
428 | 428 | build_class = "builder::MyBuilder" |
429 | 429 | |
430 | 430 | =item XSUtil.needs_compiler_c99 |
431 | 431 | |
432 | 432 | [XSUtil] |
433 | 433 | needs_compiler_c99 = 1 |
434 | 434 | |
435 | 435 | =begin original |
436 | 436 | |
437 | 437 | You can specify C<needs_compiler_c99> parameter of L<Module::Build::XSUtil>. |
438 | 438 | |
439 | 439 | =end original |
440 | 440 | |
441 | 441 | L<Module::Build::XSUtil> の C<needs_compiler_c99>> パラメータを指定できます。 |
442 | 442 | |
443 | 443 | =item XSUtil.needs_compiler_cpp |
444 | 444 | |
445 | 445 | [XSUtil] |
446 | 446 | needs_compiler_cpp = 1 |
447 | 447 | |
448 | 448 | =begin original |
449 | 449 | |
450 | 450 | You can specify C<needs_compiler_cpp> parameter of L<Module::Build::XSUtil>. |
451 | 451 | |
452 | 452 | =end original |
453 | 453 | |
454 | 454 | L<Module::Build::XSUtil> の C<needs_compiler_cpp>> パラメータを指定できます。 |
455 | 455 | |
456 | 456 | =item XSUtil.generate_ppport_h |
457 | 457 | |
458 | 458 | [XSUtil] |
459 | 459 | generate_ppport_h = 1 |
460 | 460 | |
461 | 461 | =begin original |
462 | 462 | |
463 | 463 | You can specify C<generate_ppport_h> parameter of L<Module::Build::XSUtil>. |
464 | 464 | |
465 | 465 | =end original |
466 | 466 | |
467 | 467 | L<Module::Build::XSUtil> の C<generate_ppport_h> パラメータを指定できます。 |
468 | 468 | |
469 | 469 | =item XSUtil.generate_xshelper_h |
470 | 470 | |
471 | 471 | [XSUtil] |
472 | 472 | generate_xshelper_h = 1 |
473 | 473 | |
474 | 474 | =begin original |
475 | 475 | |
476 | 476 | You can specify C<generate_xshelper_h> parameter of L<Module::Build::XSUtil>. |
477 | 477 | |
478 | 478 | =end original |
479 | 479 | |
480 | 480 | L<Module::Build::XSUtil> の C<generate_xshelper_h> パラメータを指定できます。 |
481 | 481 | |
482 | 482 | =item XSUtil.cc_warnings |
483 | 483 | |
484 | 484 | [XSUtil] |
485 | 485 | cc_warnings = 1 |
486 | 486 | |
487 | 487 | =begin original |
488 | 488 | |
489 | 489 | You can specify C<cc_warnings> parameter of L<Module::Build::XSUtil>. |
490 | 490 | |
491 | 491 | =end original |
492 | 492 | |
493 | 493 | L<Module::Build::XSUtil> の C<cc_warnings> パラメータを指定できます。 |
494 | 494 | |
495 | 495 | =item FileGatherer.exclude_match |
496 | 496 | |
497 | 497 | [FileGatherer] |
498 | 498 | exclude_match = ['^author_tools/.*'] |
499 | 499 | |
500 | 500 | =begin original |
501 | 501 | |
502 | 502 | Nothing by default. To exclude certain files from being gathered into dist, use the |
503 | 503 | C<exclude_match> option. Files matching the patterns are not gathered. |
504 | 504 | |
505 | 505 | =end original |
506 | 506 | |
507 | 507 | デフォルトにはありません。特定のファイルをディストリビューションから除外したければ、 |
508 | 508 | C<exclude_match> オプションを使ってください。パターンにマッチしたファイルは除外されます。 |
509 | 509 | |
510 | 510 | =item FileGatherer.include_dotfiles |
511 | 511 | |
512 | 512 | [FileGatherer] |
513 | 513 | include_dotfiles = false |
514 | 514 | |
515 | 515 | =begin original |
516 | 516 | |
517 | 517 | By default, files will not be included in dist if they begin with a dot. This goes |
518 | 518 | both for files and for directories. |
519 | 519 | |
520 | 520 | =end original |
521 | 521 | |
522 | 522 | デフォルトでは、ドットから始まるファイルは、ディストリビューションに含まれません。 |
523 | 523 | この設定はファイルとディレクトリの両方に及びます。 |
524 | 524 | |
525 | 525 | =begin original |
526 | 526 | |
527 | 527 | In almost all cases, the default value (false) is correct. |
528 | 528 | |
529 | 529 | =end original |
530 | 530 | |
531 | 531 | ほとんどすべての場合、デフォルトの値(偽)が正しいです。 |
532 | 532 | |
533 | 533 | =item release.pause_config |
534 | 534 | |
535 | 535 | =begin original |
536 | 536 | |
537 | 537 | [release] |
538 | 538 | pause_config = "/path/to/some/.pause" |
539 | 539 | |
540 | 540 | By setting this value to another PAUSE configuration file (see |
541 | 541 | L<cpan_upload/CONFIGURATION> for the details), it is possible to use another |
542 | 542 | PAUSE server (or anything good enough to mimick its upload process) for the |
543 | 543 | release step. |
544 | 544 | |
545 | 545 | =end original |
546 | 546 | |
547 | 547 | この値を別のPAUSE設定ファイル(詳細は次を参照 L<cpan_upload/CONFIGURATION>)に設定することで、 |
548 | 548 | リリースステップで別のPAUSEサーバ(か、PAUSEのアップロードプロセスに十分に似せた何か)を使えます。 |
549 | 549 | |
550 | 550 | =begin original |
551 | 551 | |
552 | 552 | To do so, simply add a C<upload_uri> entry in your file to the alternate PAUSE |
553 | 553 | server, i.e : |
554 | 554 | |
555 | 555 | =end original |
556 | 556 | |
557 | 557 | そうするためには、C<upload_uri>エントリを加えて、代替のPAUSEサーバにしてください。 |
558 | 558 | 例: |
559 | 559 | |
560 | 560 | upload_uri http://127.0.0.1:5000/pause/authenquery |
561 | 561 | |
562 | 562 | =begin original |
563 | 563 | |
564 | 564 | If you instantly launch your origin upload server as DarkPAN, See L<OrePAN2::Server>. |
565 | 565 | |
566 | =end | |
566 | =end original | |
567 | 567 | |
568 | 568 | DarkPan のような自分のオリジナルアップロードサーバをすぐに立ち上げたいのなら、L<OrePAN2::Server> を見てください。 |
569 | 569 | |
570 | 570 | =item release.do_not_upload_to_cpan |
571 | 571 | |
572 | 572 | [release] |
573 | 573 | do_not_upload_to_cpan=true |
574 | 574 | |
575 | 575 | =begin original |
576 | 576 | |
577 | 577 | This variable disables CPAN upload feature. |
578 | 578 | |
579 | 579 | =end original |
580 | 580 | |
581 | 581 | この値はCPANへのアップロード機能を無効にします。 |
582 | 582 | |
583 | =item release.hooks | |
584 | ||
585 | [release] | |
586 | hooks = [ | |
587 | "COMMAND1", | |
588 | "COMMAND2" | |
589 | ] | |
590 | ||
591 | =begin original | |
592 | ||
593 | Commands that are specified by this option will be executed when releasing. If result of commands is not successful, it will abort. | |
594 | ||
595 | =end original | |
596 | ||
597 | このオプションで指定されたコマンドはリリース時に実行されます。コマンドが成功しなければ、中止されます。 | |
598 | ||
583 | 599 | =item ReleaseTest.MinimumVersion |
584 | 600 | |
585 | 601 | [ReleaseTest] |
586 | 602 | MinimumVersion = false |
587 | 603 | |
588 | 604 | =begin original |
589 | 605 | |
590 | 606 | If you set this key false, Minilla will not generate 'xt/minilla/minimum_version.t'. |
591 | 607 | |
592 | 608 | =end original |
593 | 609 | |
594 | 610 | この値を偽にすると、Minilla は 'xt/minilla/minimum_version.t' を生成しません。 |
595 | 611 | |
596 | 612 | |
613 | =item requires_external_bin | |
614 | ||
615 | requires_external_bin=['tar'] | |
616 | ||
617 | =begin original | |
618 | ||
619 | The C<requires_external_bin> command takes the name of a system command | |
620 | or program. Build fail if the command does not exist. | |
621 | ||
622 | =end original | |
623 | ||
624 | C<requires_external_bin> コマンドはシステムコマンドかプログラムの名前を | |
625 | 取ります。コマンドが存在しない場合ビルドは失敗します。 | |
626 | ||
597 | 627 | =back |
598 | 628 | |
599 | 629 | =head1 FAQ |
600 | 630 | |
601 | 631 | =over 4 |
602 | 632 | |
603 | 633 | =item How can I manage B<contributors> section? |
604 | 634 | |
605 | 635 | (B<contributors>> セクションをどのように管理できますか?) |
606 | 636 | |
607 | 637 | =begin original |
608 | 638 | |
609 | 639 | Minilla aggregates contributors list from C<< git log --format="%aN <%aE>" | sort | uniq >>. |
610 | 640 | |
611 | 641 | =end original |
612 | 642 | |
613 | 643 | Minilla はコントリビュータのリストを C<< git log --format="%aN <%aE>" | sort | uniq >> からアグリゲートします。 |
614 | 644 | |
615 | 645 | =begin original |
616 | 646 | |
617 | 647 | You can merge accounts by .mailmap file. See L<https://www.kernel.org/pub/software/scm/git/docs/git-shortlog.html> |
618 | 648 | |
619 | 649 | =end original |
620 | 650 | |
621 | 651 | .mailmap ファイルで、アカウントをマージできます。 L<https://www.kernel.org/pub/software/scm/git/docs/git-shortlog.html> を見てください。 |
622 | 652 | |
623 | 653 | =item Why don't you provide plug-in support? |
624 | 654 | |
625 | 655 | (なぜ、plug-inをサポートしないのですか?) |
626 | 656 | |
627 | 657 | =begin original |
628 | 658 | |
629 | 659 | If you want a pluggable tool, it already exists: It's called L<Dist::Zilla> :P |
630 | 660 | If you like Minilla's behavior but you really want something pluggable, you can use L<Dist::Milla>, Minilla's sister project. |
631 | 661 | L<Dist::Milla>'s behavior is almost identical to that of Minilla. |
632 | 662 | |
633 | 663 | =end original |
634 | 664 | |
635 | 665 | プラガブルなツールがほしければ、既にあります: それは、L<Dist::Zilla> と呼ばれます :P |
636 | 666 | Minillaのような振る舞いが好きで、ですが、本当にプラガブルなものが欲しいならば、L<Dist::Milla>を使うことができます。Minillaの姉妹プロジェクトです。 |
637 | 667 | L<Dist::Milla> の振る舞いは Minilla と大部分一致します。 |
638 | 668 | |
639 | 669 | =item Why does minil only support git? |
640 | 670 | |
641 | 671 | (なぜ、minil は git しかサポートしないのですか?) |
642 | 672 | |
643 | 673 | =begin original |
644 | 674 | |
645 | 675 | I think git is a best VC for CPAN modules, for now. |
646 | 676 | |
647 | 677 | =end original |
648 | 678 | |
649 | 679 | 今のところ、CPANモジュールにとってgitがベストなVCだと思うからです。 |
650 | 680 | |
651 | 681 | =begin original |
652 | 682 | |
653 | 683 | If you want to use another version control system, you can probably use L<Dist::Milla>. |
654 | 684 | |
655 | 685 | =end original |
656 | 686 | |
657 | 687 | 他のバージョンコントロールシステムを使いたければ、L<Dist::Milla>を使うことができるでしょう。 |
658 | 688 | |
659 | 689 | =item And why... |
660 | 690 | |
661 | 691 | (では、なぜ...) |
662 | 692 | |
663 | 693 | =begin original |
664 | 694 | |
665 | 695 | Yes. You can use L<Dist::Milla>. |
666 | 696 | |
667 | 697 | =end original |
668 | 698 | |
669 | 699 | はい。L<Dist::Milla>を使えます。 |
670 | 700 | |
671 | 701 | =item Should I add (META.json|Build.PL) to repository? |
672 | 702 | |
673 | 703 | ((META.json|Build.PL)をリポジトリに加えるべきですか?) |
674 | 704 | |
675 | 705 | =begin original |
676 | 706 | |
677 | 707 | Yes. You need to add it to make your git repo installable via cpanm. |
678 | 708 | |
679 | 709 | =end original |
680 | 710 | |
681 | 711 | はい。cpanm で git リポジトリからのインストールを可能にするために必要です。 |
682 | 712 | |
683 | 713 | =item How do I manage ppport.h? |
684 | 714 | |
685 | 715 | (ppport.h をどのように管理しますか?) |
686 | 716 | |
687 | 717 | =begin original |
688 | 718 | |
689 | 719 | Is there a reason to remove ppport.h from repo? |
690 | 720 | |
691 | 721 | =end original |
692 | 722 | |
693 | 723 | ppport.h をリポジトリから消す理由がありますか? |
694 | 724 | |
695 | 725 | =item How can I install script files? |
696 | 726 | |
697 | 727 | (スクリプトファイルをどうやってインストールできますか?) |
698 | 728 | |
699 | 729 | =begin original |
700 | 730 | |
701 | 731 | Your executables must be in F<script/>. It's L<Module::Build::Tiny>'s rule. |
702 | 732 | |
703 | 733 | =end original |
704 | 734 | |
705 | 735 | 実行可能なものは F<script/> に入れてください。これは、L<Module::Build::Tiny>のルールです。 |
706 | 736 | |
707 | 737 | =item How to switch from Module::Install/Module::Build/Dist::Zilla? |
708 | 738 | |
709 | 739 | (Module::Install/Module::Build/Dist::Zillaからどのようにスイッチしますか?) |
710 | 740 | |
711 | 741 | =begin original |
712 | 742 | |
713 | 743 | You can use experimental `minil migrate` sub-command. |
714 | 744 | See L<Minilla::CLI::Migrate> for more details. |
715 | 745 | |
716 | 746 | =end original |
717 | 747 | |
718 | 748 | 実験的な `minil migrate` サブコマンドを使えます。 |
719 | 749 | 詳細は、L<Minilla::CLI::Migrate>を見てください。 |
720 | 750 | |
721 | 751 | =item How should I manage the files you do not want to upload to CPAN? |
722 | 752 | |
723 | 753 | (CPANにアップロードしたくないファイルをどのように管理すべきですか?) |
724 | 754 | |
725 | 755 | =begin original |
726 | 756 | |
727 | 757 | Please use FileGatherer.exclude_match for ignoring files to upload tar ball. |
728 | 758 | |
729 | 759 | =end original |
730 | 760 | |
731 | 761 | tarボールをアップロードするファイルを無視するために、FileGatherer.exclude_match を使ってください。 |
732 | 762 | |
733 | 763 | =begin original |
734 | 764 | |
735 | 765 | You can use MANIFEST.SKIP file for ignoring files. ref. L<ExtUtils::Manifest>. |
736 | 766 | |
737 | 767 | =end original |
738 | 768 | |
739 | 769 | MANIFEST.SKIP ファイルをファイルを無視するのに使えます。L<ExtUtils::Manifest> を参照。 |
770 | ||
771 | =item How do I use Module::Build::Tiny with Minilla? | |
772 | ||
773 | (どうやって、Module::Build::Tiny を Minillaで使いますか?) | |
774 | ||
775 | =begin original | |
776 | ||
777 | Minilla v0.15.0+ supports v0.15.0(EXPERIMENTAL). | |
778 | ||
779 | =end original | |
780 | ||
781 | Minilla v0.15.0+ は v0.15.0をサポートします(EXPERIMENTAL). | |
782 | ||
783 | =begin original | |
784 | ||
785 | If you want to create new project with Module::Build::Tiny, run the command as following. | |
786 | ||
787 | =end original | |
788 | ||
789 | Module::Build::Tiny を 新しいプロジェクトで作りたければ、以下のコマンドを走らせてください。 | |
790 | ||
791 | % minil new -p ModuleBuildTiny My::Awesome::Module | |
792 | ||
793 | =begin original | |
794 | ||
795 | If you want to migrate existing project, you need to rewrite minil.toml file. | |
796 | You need to add following line: | |
797 | ||
798 | =end original | |
799 | ||
800 | 存在するプロジェクトをマイグレートしたければ、minil.toml ファイルを変更する必要があります。 | |
801 | 以下の行を追加する必要があります。 | |
802 | ||
803 | module_maker="ModuleBuildTiny" | |
804 | ||
805 | =item How do I use ExtUtils::MakeMaker with Minilla? | |
806 | ||
807 | (どうやって、ExtUtils::MakeMakerをMinillaで使いますか?) | |
808 | ||
809 | =begin original | |
810 | ||
811 | Minilla v2.1.0+ supports EUMM(EXPERIMENTAL). | |
812 | ||
813 | =end original | |
814 | ||
815 | Minilla v2.1.0+ は EUMM をサポートします(EXPERIMENTAL). | |
816 | ||
817 | =begin original | |
818 | ||
819 | You need to rewrite minil.toml file. | |
820 | You need to add following line: | |
821 | ||
822 | =end original | |
823 | ||
824 | minil.toml ファイルを変更する必要があります。 | |
825 | 以下の行を追加する必要があります。 | |
826 | ||
827 | module_maker="ExtUtilsMakeMaker" | |
828 | ||
829 | =begin original | |
830 | ||
831 | (There is no profile, yet. Patches welcome.) | |
832 | ||
833 | =end original | |
834 | ||
835 | (プロファイルが、まだありません。パッチ歓迎) | |
836 | ||
837 | =begin original | |
838 | ||
839 | I don't suggest to use this module... But you can use this option for maintaining | |
840 | primitive modules like Test::TCP. | |
841 | ||
842 | =end original | |
843 | ||
844 | このモジュールを使うことをお薦めしません... ですが、Test::TCP のようなプリミティブなモジュールを | |
845 | メンテナンスするために、このオプションを使うことができます。 | |
740 | 846 | |
741 | 847 | =back |
742 | 848 | |
743 | 849 | =head1 AUTHORS |
744 | 850 | |
745 | 851 | Tokuhiro Matsuno E<lt> tokuhirom@gmail.com E<gt> |
746 | 852 | |
747 | 853 | Tatsuhiko Miyagawa |
748 | 854 | |
749 | 855 | =head1 THANKS TO |
750 | 856 | |
751 | 857 | RJBS, the author of L<Dist::Zilla>. L<Dist::Zilla> points CPAN authorizing tool. |
752 | 858 | |
753 | 859 | =head1 SEE ALSO |
754 | 860 | |
755 | 861 | =head1 LICENSE |
756 | 862 | |
757 | 863 | Copyright (C) Tokuhiro Matsuno |
758 | 864 | |
759 | 865 | This library is free software; you can redistribute it and/or modify |
760 | 866 | it under the same terms as Perl itself. |
761 | 867 | |
762 | 868 | |
763 | 869 | =cut |