|
| 1 | +# SOME DESCRIPTIVE TITLE. |
| 2 | +# Copyright (C) 2025, pyOpenSci |
| 3 | +# This file is distributed under the same license as the pyOpenSci Python |
| 4 | +# Package Guide package. |
| 5 | +# FIRST AUTHOR <EMAIL@ADDRESS>, 2025. |
| 6 | +# |
| 7 | +#, fuzzy |
| 8 | +msgid "" |
| 9 | +msgstr "" |
| 10 | +"Project-Id-Version: pyOpenSci Python Package Guide \n" |
| 11 | +"Report-Msgid-Bugs-To: \n" |
| 12 | +"POT-Creation-Date: 2025-04-20 11:32+0900\n" |
| 13 | +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" |
| 14 | +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" |
| 15 | +"Language: ja\n" |
| 16 | +"Language-Team: ja <LL@li.org>\n" |
| 17 | +"Plural-Forms: nplurals=1; plural=0;\n" |
| 18 | +"MIME-Version: 1.0\n" |
| 19 | +"Content-Type: text/plain; charset=utf-8\n" |
| 20 | +"Content-Transfer-Encoding: 8bit\n" |
| 21 | +"Generated-By: Babel 2.17.0\n" |
| 22 | + |
| 23 | +#: ../../continuous-integration/ci.md:2 |
| 24 | +msgid "" |
| 25 | +"Continuous Integration and Continuous Deployment (CI/CD) For Python " |
| 26 | +"Packages" |
| 27 | +msgstr "" |
| 28 | + |
| 29 | +#: ../../continuous-integration/ci.md:4 |
| 30 | +msgid "" |
| 31 | +"When you develop, work on, and contribute to software, there is more to " |
| 32 | +"consider than just writing code. Having tests and checks ensures that " |
| 33 | +"your code runs reliably and follows a consistent format is also " |
| 34 | +"important. You can use **Continuous Integration (CI)** and **Continuous " |
| 35 | +"Deployment (CD)** to run tests and checks on your code every time someone" |
| 36 | +" suggests a change online in a platform like GitHub or GitLab." |
| 37 | +msgstr "" |
| 38 | + |
| 39 | +#: ../../continuous-integration/ci.md:11 |
| 40 | +msgid "" |
| 41 | +"**Continuous Integration (CI):** Automates the process of running tests, " |
| 42 | +"code checks, and other workflows each time code is updated." |
| 43 | +msgstr "" |
| 44 | + |
| 45 | +#: ../../continuous-integration/ci.md:13 |
| 46 | +msgid "" |
| 47 | +"**Continuous Deployment (CD):** Extends CI by allowing you to automate " |
| 48 | +"publishing your package to PyPI, publishing your documentation, and more." |
| 49 | +msgstr "" |
| 50 | + |
| 51 | +#: ../../continuous-integration/ci.md:15 |
| 52 | +msgid "" |
| 53 | +"CI and CD streamline software development by automating repetitive tasks " |
| 54 | +"and ensuring code quality and consistency. Having CI setup also makes it " |
| 55 | +"easier for new contributors to contribute to your code base without " |
| 56 | +"setting up all your test suites and other local checks." |
| 57 | +msgstr "" |
| 58 | + |
| 59 | +#: ../../continuous-integration/ci.md:20 |
| 60 | +msgid "What is continuous integration?" |
| 61 | +msgstr "" |
| 62 | + |
| 63 | +#: ../../continuous-integration/ci.md:22 |
| 64 | +msgid "" |
| 65 | +"When you’re ready to publish your code online, you can set up Continuous " |
| 66 | +"Integration (CI). CI is a platform that allows you to specify and run " |
| 67 | +"jobs or workflows you define. These workflows include:" |
| 68 | +msgstr "" |
| 69 | + |
| 70 | +#: ../../continuous-integration/ci.md:25 |
| 71 | +msgid "Running your test suite" |
| 72 | +msgstr "" |
| 73 | + |
| 74 | +#: ../../continuous-integration/ci.md:26 |
| 75 | +msgid "Running code checkers / linters / spellcheck" |
| 76 | +msgstr "" |
| 77 | + |
| 78 | +#: ../../continuous-integration/ci.md:27 |
| 79 | +msgid "Building your documentation" |
| 80 | +msgstr "" |
| 81 | + |
| 82 | +#: ../../continuous-integration/ci.md:29 |
| 83 | +msgid "" |
| 84 | +"CI allows you to automate running workflows across a suite of " |
| 85 | +"environments, including:" |
| 86 | +msgstr "" |
| 87 | + |
| 88 | +#: ../../continuous-integration/ci.md:31 |
| 89 | +msgid "environments containing different Python versions and" |
| 90 | +msgstr "" |
| 91 | + |
| 92 | +#: ../../continuous-integration/ci.md:32 |
| 93 | +msgid "different operating systems (Mac, Linux, Windows)." |
| 94 | +msgstr "" |
| 95 | + |
| 96 | +#: ../../continuous-integration/ci.md:34 |
| 97 | +msgid "What is Continuous Deployment (CD)?" |
| 98 | +msgstr "" |
| 99 | + |
| 100 | +#: ../../continuous-integration/ci.md:36 |
| 101 | +msgid "" |
| 102 | +"Continuous deployment (CD) extends the CI process by automating the " |
| 103 | +"deployment of code changes to production or staging environments. In the " |
| 104 | +"case of your open source tool, CD can be used to:" |
| 105 | +msgstr "" |
| 106 | + |
| 107 | +#: ../../continuous-integration/ci.md:38 |
| 108 | +msgid "Automate publishing to PyPI" |
| 109 | +msgstr "" |
| 110 | + |
| 111 | +#: ../../continuous-integration/ci.md:39 |
| 112 | +msgid "Automate publishing your documentation to GitHub Pages or Read the Docs." |
| 113 | +msgstr "" |
| 114 | + |
| 115 | +#: ../../continuous-integration/ci.md:41 |
| 116 | +msgid "" |
| 117 | +"It is also used once your conda-forge recipe is set up to keep your " |
| 118 | +"package up to date on conda-forge." |
| 119 | +msgstr "" |
| 120 | + |
| 121 | +#: ../../continuous-integration/ci.md:43 |
| 122 | +msgid "Why use CI" |
| 123 | +msgstr "" |
| 124 | + |
| 125 | +#: ../../continuous-integration/ci.md:45 |
| 126 | +msgid "" |
| 127 | +"CI can be configured to run a workflow on every commit pushed to GitHub " |
| 128 | +"and every pull request opened. This ensures that any changes made to your" |
| 129 | +" package are tested across environments before merging into the main " |
| 130 | +"branch of your code." |
| 131 | +msgstr "" |
| 132 | + |
| 133 | +#: ../../continuous-integration/ci.md:47 |
| 134 | +msgid "" |
| 135 | +"These checks are particularly useful if someone new is contributing to " |
| 136 | +"your code. Every contributor's change will be tested when pushed to your " |
| 137 | +"code repository." |
| 138 | +msgstr "" |
| 139 | + |
| 140 | +#: ../../continuous-integration/ci.md:49 |
| 141 | +msgid "" |
| 142 | +"Together, CI and CD streamline the process of building, testing, and " |
| 143 | +"deploying code. They aim to improve software development and publication " |
| 144 | +"efficiency, quality, and reliability." |
| 145 | +msgstr "" |
| 146 | + |
| 147 | +#: ../../continuous-integration/ci.md:52 |
| 148 | +msgid "" |
| 149 | +"All pyOpenSci packages must use some form of continuous integration. Even" |
| 150 | +" if you are not planning to go through peer review, we strongly recommend" |
| 151 | +" that you use continuous integration, too!" |
| 152 | +msgstr "" |
| 153 | + |
| 154 | +#: ../../continuous-integration/ci.md:55 |
| 155 | +msgid "" |
| 156 | +"In the case of GitHub actions (which we will focus on here), CI workflows" |
| 157 | +" are running on online servers that support GitHub." |
| 158 | +msgstr "" |
| 159 | + |
| 160 | +#: ../../continuous-integration/ci.md:57 |
| 161 | +msgid "CI / CD platforms" |
| 162 | +msgstr "" |
| 163 | + |
| 164 | +#: ../../continuous-integration/ci.md:59 |
| 165 | +msgid "" |
| 166 | +"There are numerous platforms available for CI/CD. Here, we will focus on " |
| 167 | +"GitHub Actions (GHA), built into GitHub. GitHub is the most commonly used" |
| 168 | +" platform to store scientific open-source software." |
| 169 | +msgstr "" |
| 170 | + |
| 171 | +#: ../../continuous-integration/ci.md:62 |
| 172 | +msgid "" |
| 173 | +"If you use [GitLab](https://about.gitlab.com/) CI/CD, many of the " |
| 174 | +"principles described here will apply. However, the workflow files may " |
| 175 | +"look different." |
| 176 | +msgstr "" |
| 177 | + |
| 178 | +#: ../../continuous-integration/ci.md:65 |
| 179 | +msgid "If you aren't sure, use GitHub Actions" |
| 180 | +msgstr "" |
| 181 | + |
| 182 | +#: ../../continuous-integration/ci.md:67 |
| 183 | +msgid "" |
| 184 | +"While you are welcome to use the continuous integration platform of your " |
| 185 | +"choice, we recommend GitHub Actions because it is free-to-use and " |
| 186 | +"integrated tightly into the GitHub user interface. There is also an " |
| 187 | +"entire store of GitHub action templates that you can easily use and adapt" |
| 188 | +" to your own needs." |
| 189 | +msgstr "" |
| 190 | + |
| 191 | +#: ../../continuous-integration/ci.md:72 |
| 192 | +msgid "Other platforms that you may run into" |
| 193 | +msgstr "" |
| 194 | + |
| 195 | +#: ../../continuous-integration/ci.md:75 |
| 196 | +msgid "" |
| 197 | +"[Appveyor:](https://www.appveyor.com/): Supports running tests on Windows" |
| 198 | +" operating systems and predated the release of GitHub Actions. Today, " |
| 199 | +"AppVeyor supports operating systems beyond Windows." |
| 200 | +msgstr "" |
| 201 | + |
| 202 | +#: ../../continuous-integration/ci.md:76 |
| 203 | +msgid "" |
| 204 | +"[Travis CI:](https://www.travis-ci.com/) had been a common CI platform " |
| 205 | +"choice in our ecosystem. Usage dropped after Travis CI ended free support" |
| 206 | +" for open-source projects." |
| 207 | +msgstr "" |
| 208 | + |
| 209 | +#: ../../continuous-integration/ci.md:77 |
| 210 | +msgid "" |
| 211 | +"[CircleCI:](https://circleci.com/) CircleCI can be useful for automated " |
| 212 | +"builds of websites and documentation since it offers a preview of the PR " |
| 213 | +"changes." |
| 214 | +msgstr "" |
| 215 | + |
| 216 | +#: ../../continuous-integration/ci.md:80 |
| 217 | +msgid "Embrace automation" |
| 218 | +msgstr "" |
| 219 | + |
| 220 | +#: ../../continuous-integration/ci.md:82 |
| 221 | +msgid "" |
| 222 | +"By embracing CI/CD, you can ensure that your code runs as you expect it " |
| 223 | +"to across the diverse landscapes of user environments. Further, you can " |
| 224 | +"automate certain checks (and, in some cases, code fixes), including " |
| 225 | +"linting and code style. You can even automate spell-checking your " |
| 226 | +"documentation and docstrings!" |
| 227 | +msgstr "" |
| 228 | + |
| 229 | +#: ../../continuous-integration/index.md:5 |
| 230 | +msgid "What is CI?" |
| 231 | +msgstr "" |
| 232 | + |
| 233 | +#: ../../continuous-integration/index.md:5 |
| 234 | +msgid "Continuous Integration" |
| 235 | +msgstr "" |
| 236 | + |
| 237 | +#: ../../continuous-integration/index.md:2 |
| 238 | +msgid "" |
| 239 | +"Continuous Integration (CI) and Continuous Deployment (CD) for your " |
| 240 | +"Python package" |
| 241 | +msgstr "" |
0 commit comments