9
9
msgstr ""
10
10
"Project-Id-Version : pyOpenSci Python Package Guide \n "
11
11
"Report-Msgid-Bugs-To : \n "
12
- "POT-Creation-Date : 2024-07-03 16:27-0400 \n "
12
+ "POT-Creation-Date : 2024-08-02 18:04+0900 \n "
13
13
"PO-Revision-Date : YEAR-MO-DA HO:MI+ZONE\n "
14
14
"Last-Translator : FULL NAME <EMAIL@ADDRESS>\n "
15
15
"Language : es\n "
@@ -119,201 +119,222 @@ msgstr ""
119
119
#: ../../CONTRIBUTING.md:35
120
120
msgid ""
121
121
"Independently of the approach you choose, the first step is to fork the "
122
- "Python Packaging Guide repository into your personal GitHub space."
122
+ "Python Packaging Guide repository into your personal GitHub space. To "
123
+ "\" fork\" a repository in GitHub means to create a copy of the main "
124
+ "repository, or repo, that you have complete control over and can modify "
125
+ "as you see fit."
123
126
msgstr ""
124
127
125
128
#: ../../CONTRIBUTING.md:37
126
- msgid ""
127
- "*__TODO__: This section should show a beginner user how to fork a "
128
- "repository in GitHub.*"
129
+ msgid "To fork a repo,"
129
130
msgstr ""
130
131
131
132
#: ../../CONTRIBUTING.md:39
132
- msgid "Contributing via the GitHub website "
133
+ msgid "Make sure you are logged into GitHub. "
133
134
msgstr ""
134
135
135
136
#: ../../CONTRIBUTING.md:41
136
- msgid "How to edit a MarkDown file"
137
+ msgid ""
138
+ "Go to the repo you would like to fork, in this case the [Python Packaging"
139
+ " Guide](https://www.github.com/pyopensci/python-package-guide) repo."
137
140
msgstr ""
138
141
139
142
#: ../../CONTRIBUTING.md:43
140
143
msgid ""
144
+ "In the top right-hand corner of the page there is a 'Fork' button. Click "
145
+ "that button. You will be brought to a new page where you will 'Create a "
146
+ "new fork'. Feel free to keep all the default inputs and click 'Create "
147
+ "fork'. This will create a copy of the repo at "
148
+ "`https://github.com/<username>/python-package-guide`, where `<username>` "
149
+ "is your GitHub username."
150
+ msgstr ""
151
+
152
+ #: ../../CONTRIBUTING.md:47
153
+ msgid "Contributing via the GitHub website"
154
+ msgstr ""
155
+
156
+ #: ../../CONTRIBUTING.md:49
157
+ msgid "How to edit a MarkDown file"
158
+ msgstr ""
159
+
160
+ #: ../../CONTRIBUTING.md:51
161
+ msgid ""
141
162
"*__TODO__: This section should show how to use the GitHub interface to "
142
163
"edit and previewing a Markdown file.*"
143
164
msgstr ""
144
165
145
- #: ../../CONTRIBUTING.md:45
166
+ #: ../../CONTRIBUTING.md:53
146
167
msgid "How to commit your changes"
147
168
msgstr ""
148
169
149
- #: ../../CONTRIBUTING.md:47
170
+ #: ../../CONTRIBUTING.md:55
150
171
msgid ""
151
172
"*__TODO__: This section should show how to commit changes via the GitHub "
152
173
"interface.*"
153
174
msgstr ""
154
175
155
- #: ../../CONTRIBUTING.md:49
176
+ #: ../../CONTRIBUTING.md:57
156
177
msgid "Contributing locally on your computer"
157
178
msgstr ""
158
179
159
- #: ../../CONTRIBUTING.md:51
180
+ #: ../../CONTRIBUTING.md:59
160
181
msgid "Clone your forked repository"
161
182
msgstr ""
162
183
163
- #: ../../CONTRIBUTING.md:53
184
+ #: ../../CONTRIBUTING.md:61
164
185
msgid ""
165
186
"*__TODO__: This section should show how to clone a repository from GitHub"
166
187
" into your computer.*"
167
188
msgstr ""
168
189
169
- #: ../../CONTRIBUTING.md:55
190
+ #: ../../CONTRIBUTING.md:63
170
191
msgid "Create a new branch"
171
192
msgstr ""
172
193
173
- #: ../../CONTRIBUTING.md:57
194
+ #: ../../CONTRIBUTING.md:65
174
195
msgid "*__TODO__: This section should show how to create a new branch.*"
175
196
msgstr ""
176
197
177
- #: ../../CONTRIBUTING.md:59
198
+ #: ../../CONTRIBUTING.md:67
178
199
msgid "Create a virtual environment"
179
200
msgstr ""
180
201
181
- #: ../../CONTRIBUTING.md:61
202
+ #: ../../CONTRIBUTING.md:69
182
203
msgid ""
183
204
"*__TODO__: This section should show how to create a virtual environment "
184
205
"using venv.*"
185
206
msgstr ""
186
207
187
- #: ../../CONTRIBUTING.md:63
208
+ #: ../../CONTRIBUTING.md:71
188
209
msgid "Install the development dependencies"
189
210
msgstr ""
190
211
191
- #: ../../CONTRIBUTING.md:65
212
+ #: ../../CONTRIBUTING.md:73
192
213
msgid ""
193
214
"*__TODO__: This section should show how to install the development "
194
215
"dependencies defined in pyproject.toml.*"
195
216
msgstr ""
196
217
197
- #: ../../CONTRIBUTING.md:67
218
+ #: ../../CONTRIBUTING.md:75
198
219
msgid "Commit your changes"
199
220
msgstr ""
200
221
201
- #: ../../CONTRIBUTING.md:69
222
+ #: ../../CONTRIBUTING.md:77
202
223
msgid ""
203
224
"*__TODO__: This section should describe how to commit from the command "
204
225
"line.*"
205
226
msgstr ""
206
227
207
- #: ../../CONTRIBUTING.md:71
228
+ #: ../../CONTRIBUTING.md:79
208
229
msgid "How to build the guide locally"
209
230
msgstr ""
210
231
211
- #: ../../CONTRIBUTING.md:73
232
+ #: ../../CONTRIBUTING.md:81
212
233
msgid ""
213
234
"*__TODO__: This section should describe the different sessions in nox "
214
235
"related to building the docs: docs, docs-test, docs-live. It should also "
215
236
"show how to see the guide built locally, by opening the right file in the"
216
237
" browser or using the live version from docs-live*"
217
238
msgstr ""
218
239
219
- #: ../../CONTRIBUTING.md:75
240
+ #: ../../CONTRIBUTING.md:83
220
241
msgid "Before you submit your pull request"
221
242
msgstr ""
222
243
223
- #: ../../CONTRIBUTING.md:77
244
+ #: ../../CONTRIBUTING.md:85
224
245
msgid ""
225
246
"*__TODO__: This section should describe what steps a user should follow "
226
247
"before submitting the pull request: build the docs, verify your changes "
227
248
"look correct, etc.*"
228
249
msgstr ""
229
250
230
- #: ../../CONTRIBUTING.md:79
251
+ #: ../../CONTRIBUTING.md:87
231
252
msgid "Submitting a pull request with your contribution"
232
253
msgstr ""
233
254
234
- #: ../../CONTRIBUTING.md:81
255
+ #: ../../CONTRIBUTING.md:89
235
256
msgid "How to make a pull request"
236
257
msgstr ""
237
258
238
- #: ../../CONTRIBUTING.md:83
259
+ #: ../../CONTRIBUTING.md:91
239
260
msgid ""
240
261
"*__TODO__: This section should describe how to make a pull request in "
241
262
"GitHub.*"
242
263
msgstr ""
243
264
244
- #: ../../CONTRIBUTING.md:85
265
+ #: ../../CONTRIBUTING.md:93
245
266
msgid "What happens when you submit a pull request (CI/CD)"
246
267
msgstr ""
247
268
248
- #: ../../CONTRIBUTING.md:87
269
+ #: ../../CONTRIBUTING.md:95
249
270
msgid ""
250
271
"*__TODO__: This section should describe how to see the results of the "
251
272
"CD/CI checks and how to get more information about errors*"
252
273
msgstr ""
253
274
254
- #: ../../CONTRIBUTING.md:89
275
+ #: ../../CONTRIBUTING.md:97
255
276
msgid "What to expect from the review process"
256
277
msgstr ""
257
278
258
- #: ../../CONTRIBUTING.md:91
279
+ #: ../../CONTRIBUTING.md:99
259
280
msgid ""
260
281
"*__TODO__: This section should describe how review happens in GitHub, how"
261
282
" see the comments, and how to submit changes (push a new branch)*"
262
283
msgstr ""
263
284
264
- #: ../../CONTRIBUTING.md:93
285
+ #: ../../CONTRIBUTING.md:101
265
286
msgid "Additional help"
266
287
msgstr ""
267
288
268
- #: ../../CONTRIBUTING.md:95
289
+ #: ../../CONTRIBUTING.md:103
269
290
msgid "How to get help"
270
291
msgstr ""
271
292
272
- #: ../../CONTRIBUTING.md:97
293
+ #: ../../CONTRIBUTING.md:105
273
294
msgid ""
274
295
"*__TODO__: This section should describe the options for finding more help"
275
296
" in case beginner contributors need more help (e.g., create an issue, "
276
297
"post in a forum, etc).*"
277
298
msgstr ""
278
299
279
- #: ../../CONTRIBUTING.md:99
300
+ #: ../../CONTRIBUTING.md:107
280
301
msgid "Additional resources"
281
302
msgstr ""
282
303
283
- #: ../../CONTRIBUTING.md:101
304
+ #: ../../CONTRIBUTING.md:109
284
305
msgid ""
285
306
"*__TODO__: It should also include links to beginner documentation, like "
286
307
"the GitHub docs.*"
287
308
msgstr ""
288
309
289
- #: ../../CONTRIBUTING.md:103
310
+ #: ../../CONTRIBUTING.md:111
290
311
msgid "Annex"
291
312
msgstr ""
292
313
293
- #: ../../CONTRIBUTING.md:105
314
+ #: ../../CONTRIBUTING.md:113
294
315
msgid "Code examples"
295
316
msgstr ""
296
317
297
- #: ../../CONTRIBUTING.md:107
318
+ #: ../../CONTRIBUTING.md:115
298
319
msgid ""
299
320
"This guide uses the [literalinclude Sphinx directive](https://www.sphinx-"
300
321
"doc.org/en/master/usage/restructuredtext/directives.html#directive-"
301
322
"literalinclude) whenever possible to keep code and prose separate. Code "
302
323
"for use in the documentation is kept in the `examples/` folder."
303
324
msgstr ""
304
325
305
- #: ../../CONTRIBUTING.md:111
326
+ #: ../../CONTRIBUTING.md:119
306
327
msgid "Referencing code in documentation"
307
328
msgstr ""
308
329
309
- #: ../../CONTRIBUTING.md:113
330
+ #: ../../CONTRIBUTING.md:121
310
331
msgid ""
311
332
"If an example is present elsewhere in the documentation that you want to "
312
333
"use, you can copy the `literalinclude` directive verbatim and the "
313
334
"examples will stay in sync."
314
335
msgstr ""
315
336
316
- #: ../../CONTRIBUTING.md:116
337
+ #: ../../CONTRIBUTING.md:124
317
338
msgid ""
318
339
"If you already see code in the examples folder that you can use for new "
319
340
"documentation, a new `literalinclude` can be made to extract it into the "
@@ -323,25 +344,25 @@ msgid ""
323
344
"the later can protect your example from future modifications to the code."
324
345
msgstr ""
325
346
326
- #: ../../CONTRIBUTING.md:121
347
+ #: ../../CONTRIBUTING.md:129
327
348
msgid ""
328
349
"**Pro tip**: As an alternative to `:lines:` there are also the `:start-"
329
350
"after:`, `:start-at:`, `:end-before:`, and `:end-at:` options. And if the"
330
351
" example code is Python, `:pyobject:` can be an even more future-proof "
331
352
"way to keep the same documentation content even through code refactors."
332
353
msgstr ""
333
354
334
- #: ../../CONTRIBUTING.md:125
355
+ #: ../../CONTRIBUTING.md:133
335
356
msgid ""
336
357
"If you need example code that doesn't yet exist in `examples/` see "
337
358
"creating code for documentation](#creating-code-for-documentation)."
338
359
msgstr ""
339
360
340
- #: ../../CONTRIBUTING.md:128
361
+ #: ../../CONTRIBUTING.md:136
341
362
msgid "Creating code for documentation"
342
363
msgstr ""
343
364
344
- #: ../../CONTRIBUTING.md:130
365
+ #: ../../CONTRIBUTING.md:138
345
366
msgid ""
346
367
"Whenever you come across a place that could benefit from a code block, "
347
368
"instead of writing it in-line with a code fence (`` ``` `` blocked text) "
@@ -350,7 +371,7 @@ msgid ""
350
371
"code-in-documentation)."
351
372
msgstr ""
352
373
353
- #: ../../CONTRIBUTING.md:134
374
+ #: ../../CONTRIBUTING.md:142
354
375
msgid ""
355
376
"If you want to add a new example that doesn't fit into any of the "
356
377
"existing example files, you can create a new file and reference it in a "
@@ -359,7 +380,7 @@ msgid ""
359
380
"create a new folder in the `examples` directory."
360
381
msgstr ""
361
382
362
- #: ../../CONTRIBUTING.md:138
383
+ #: ../../CONTRIBUTING.md:146
363
384
msgid ""
364
385
"If an existing example is incomplete or a new example makes sense to be "
365
386
"added to an existing file, go ahead and add it, but take care to not "
@@ -368,14 +389,14 @@ msgid ""
368
389
"file, new methods after all existing ones in a class."
369
390
msgstr ""
370
391
371
- #: ../../CONTRIBUTING.md:142
392
+ #: ../../CONTRIBUTING.md:150
372
393
msgid ""
373
394
"Example code is checked for correctness, so adding a new example may "
374
395
"require adding additional tests for coverage, and will require fixing any"
375
396
" failing tests."
376
397
msgstr ""
377
398
378
- #: ../../CONTRIBUTING.md:145
399
+ #: ../../CONTRIBUTING.md:153
379
400
msgid ""
380
401
"***⚠️ WARNING***: great care should be taken when modifying existing "
381
402
"example code, especially any modification beyond appending to the end of "
@@ -386,29 +407,43 @@ msgid ""
386
407
"and then checking those pages in a new build."
387
408
msgstr ""
388
409
389
- #: ../../CONTRIBUTING.md:153
410
+ #: ../../CONTRIBUTING.md:161
390
411
msgid "Example:"
391
412
msgstr ""
392
413
393
- #: ../../CONTRIBUTING.md:155
414
+ #: ../../CONTRIBUTING.md:163
394
415
msgid "Instead of writing example code in markdown like this"
395
416
msgstr ""
396
417
397
- #: ../../CONTRIBUTING.md:166
418
+ #: ../../CONTRIBUTING.md:174
398
419
msgid "The python can be extracted into a `.py` file"
399
420
msgstr ""
400
421
401
- #: ../../CONTRIBUTING.md:180
422
+ #: ../../CONTRIBUTING.md:188
402
423
msgid ""
403
424
"As another example, if you only need to show part of a `pyproject.toml`, "
404
425
"we already have complete project definitions, you need only to find the "
405
426
"relevant part."
406
427
msgstr ""
407
428
408
- #: ../../CONTRIBUTING.md:183
429
+ #: ../../CONTRIBUTING.md:191
409
430
msgid "Instead of writing this"
410
431
msgstr ""
411
432
412
- #: ../../CONTRIBUTING.md:195
433
+ #: ../../CONTRIBUTING.md:203
413
434
msgid "an example could be extracted from an existing toml file"
414
435
msgstr ""
436
+
437
+ #~ msgid ""
438
+ #~ "Independently of the approach you "
439
+ #~ "choose, the first step is to fork"
440
+ #~ " the Python Packaging Guide repository "
441
+ #~ "into your personal GitHub space."
442
+ #~ msgstr ""
443
+
444
+ #~ msgid ""
445
+ #~ "*__TODO__: This section should show a"
446
+ #~ " beginner user how to fork a "
447
+ #~ "repository in GitHub.*"
448
+ #~ msgstr ""
449
+
0 commit comments