You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
"and running new specialist tools in many disciplines.\n"
"We do not teach HPC or domain-specific skills here\n"
"but lay the groundwork for further development of these skills.\n"
"In particular,\n"
"understanding the syntax of commands, flags, and help systems is useful for domain specific tools\n"
"and understanding the file system (and how to navigate it) is useful for remote access."
#:shell-novice/_extras/guide.md:67
msgid""
"Finally,\n"
"and perhaps most importantly,\n"
"teaching people the shell lets us teach them\n"
"to think about programming in terms of function composition.\n"
"In the case of the shell,\n"
"this takes the form of pipelines rather than nested function calls,\n"
"but the core idea of \"small pieces, loosely joined\" is the same."
msgstr""
"Finally,\n"
"and perhaps most importantly,\n"
"teaching people the shell lets us teach them\n"
"to think about programming in terms of function composition.\n"
"In the case of the shell,\n"
"this takes the form of pipelines rather than nested function calls,\n"
"but the core idea of \"small pieces, loosely joined\" is the same."
#:shell-novice/_extras/guide.md:75
msgid""
"All of this material can be covered in three hours\n"
"as long as learners using Windows do not run into roadblocks such as:"
msgstr""
"All of this material can be covered in three hours\n"
"as long as learners using Windows do not run into roadblocks such as:"
# unordered list
#:shell-novice/_extras/guide.md:78
msgid"* not being able to figure out where their home directory is"
msgstr"* not being able to figure out where their home directory is"
#:shell-novice/_extras/guide.md:79
msgid""
" (particularly if they're using Cygwin);\n"
"* not being able to run a plain text editor;\n"
" and\n"
"* the shell refusing to run scripts that include DOS line endings."
msgstr""
" (particularly if they're using Cygwin);\n"
"* not being able to run a plain text editor;\n"
" and\n"
"* the shell refusing to run scripts that include DOS line endings."
# header
#:shell-novice/_extras/guide.md:84
msgid"## Preparing to Teach"
msgstr"## Preparing to Teach"
# unordered list
#:shell-novice/_extras/guide.md:86
msgid"* Use the `data` directory for in-workshop exercises and live coding examples."
msgstr"* Use the `data` directory for in-workshop exercises and live coding examples."
#:shell-novice/_extras/guide.md:87
msgid""
" You can clone the shell-novice directory or use the `Download ZIP`\n"
" button on the right to get the entire [repository](https://github.com/swcarpentry/shell-novice). We also now provide\n"
" a zip file of the `data` directory that can be downloaded on its own\n"
" from the repository by right-click + save or see the [\"setup\"]({{ page.root }}/setup/) page on the lesson website for more details. "
msgstr""
" You can clone the shell-novice directory or use the `Download ZIP`\n"
" button on the right to get the entire [repository](https://github.com/swcarpentry/shell-novice). We also now provide\n"
" a zip file of the `data` directory that can be downloaded on its own\n"
" from the repository by right-click + save or see the [\"setup\"]({{ page.root }}/setup/) page on the lesson website for more details. "
# unordered list
#:shell-novice/_extras/guide.md:92
msgid"* Website: various practices have been used."
msgstr"* Website: various practices have been used."
# unordered list
#:shell-novice/_extras/guide.md:93
msgid" * Option 1: Can give links to learners before the lesson so they can follow along,"
msgstr" * Option 1: Can give links to learners before the lesson so they can follow along,"
#:shell-novice/_extras/guide.md:94
msgid""
" catch up,\n"
"\tand see exercises (particularly if you're following the lesson content without many changes).\n"
" * Option 2: Don't show the website to the learners during the lesson, as it can be distracting:\n"
" students may read instead of listen, and having another window open is an additional cognitive load.\n"
"\t* In any case, make sure to point to website as a post-workshop reference."
msgstr""
" catch up,\n"
"\tand see exercises (particularly if you're following the lesson content without many changes).\n"
" * Option 2: Don't show the website to the learners during the lesson, as it can be distracting:\n"
" students may read instead of listen, and having another window open is an additional cognitive load.\n"
"\t* In any case, make sure to point to website as a post-workshop reference."
# unordered list
#:shell-novice/_extras/guide.md:100
msgid"* Content:"
msgstr"* Content:"
#:shell-novice/_extras/guide.md:101
msgid""
" Unless you have a truly generous amount of time (4+ hours),\n"
" it is likely that you will not cover ALL the material in this lesson in a single half-day session.\n"
" Plan ahead on what you might skip, what you really want to emphasize, etc."
msgstr""
" Unless you have a truly generous amount of time (4+ hours),\n"
" it is likely that you will not cover ALL the material in this lesson in a single half-day session.\n"
" Plan ahead on what you might skip, what you really want to emphasize, etc."
# unordered list
#:shell-novice/_extras/guide.md:105
msgid"* Exercises:"
msgstr"* Exercises:"
#:shell-novice/_extras/guide.md:106
msgid""
" Think in advance about how you might want to handle exercises during the lesson.\n"
" How are you assigning them (website, slide, handout)?\n"
" Do you want everyone to try it and then you show the solution?\n"
" Have a learner show the solution?\n"
" Have groups each do a different exercise and present their solutions?"
msgstr""
" Think in advance about how you might want to handle exercises during the lesson.\n"
" How are you assigning them (website, slide, handout)?\n"
" Do you want everyone to try it and then you show the solution?\n"
" Have a learner show the solution?\n"
" Have groups each do a different exercise and present their solutions?"
# unordered list
#:shell-novice/_extras/guide.md:112
msgid"* `reference.md` can be printed out and given to students as a reference, your choice."
msgstr"* `reference.md` can be printed out and given to students as a reference, your choice."
# unordered list
#:shell-novice/_extras/guide.md:114
msgid"* Other preparation:"
msgstr"* Other preparation:"
#:shell-novice/_extras/guide.md:115
msgid""
" Feel free to add your own examples or side comments,\n"
" but know that it shouldn't be necessary:\n"
" the topics and commands can be taught as given on the lesson pages.\n"
" If you think there is a place where the lesson is lacking,\n"
" feel free to file an issue or submit a pull request."
msgstr""
" Feel free to add your own examples or side comments,\n"
" but know that it shouldn't be necessary:\n"
" the topics and commands can be taught as given on the lesson pages.\n"
" If you think there is a place where the lesson is lacking,\n"
" feel free to file an issue or submit a pull request."
# header
#:shell-novice/_extras/guide.md:121
msgid"## Teaching Notes"
msgstr"## Teaching Notes"
# unordered list
#:shell-novice/_extras/guide.md:123
msgid"* Super cool online resource!"
msgstr"* Super cool online resource!"
#:shell-novice/_extras/guide.md:124
msgid""
" <http://explainshell.com/> will dissect any shell command you type in\n"
" and display help text for each piece. Additional nice manual tool could be <http://tldr-pages.github.io/> with short very descriptive manuals for shell commands, useful especially on Windows while using Git BASH where `man` could not work."
msgstr""
" <http://explainshell.com/> will dissect any shell command you type in\n"
" and display help text for each piece. Additional nice manual tool could be <http://tldr-pages.github.io/> with short very descriptive manuals for shell commands, useful especially on Windows while using Git BASH where `man` could not work."
# unordered list
#:shell-novice/_extras/guide.md:127
msgid"* Another super cool online resource is <http://www.shellcheck.net>,"
msgstr"* Another super cool online resource is <http://www.shellcheck.net>,"
#:shell-novice/_extras/guide.md:128
msgid" which will check shell scripts (both uploaded and typed in) for common errors."
msgstr" which will check shell scripts (both uploaded and typed in) for common errors."
# unordered list
#:shell-novice/_extras/guide.md:130
msgid"* Resources for \"splitting\" your shell so that recent commands"
msgstr"* Resources for \"splitting\" your shell so that recent commands"
#:shell-novice/_extras/guide.md:131
msgid" remain in view: <https://github.com/rgaiacs/swc-shell-split-window>."
msgstr" remain in view: <https://github.com/rgaiacs/swc-shell-split-window>."
# unordered list
#:shell-novice/_extras/guide.md:133
msgid"* Running a text editor from the command line can be"
msgstr"* Running a text editor from the command line can be"
#:shell-novice/_extras/guide.md:134
msgid""
" the biggest stumbling block during the entire lesson:\n"
" many will try to run the same editor as the instructor\n"
" (which may leave them trapped in the awful nether hell that is Vim),\n"
" or will not know how to navigate to the right directory\n"
" to save their file,\n"
" or will run a word processor rather than a plain text editor.\n"
" The quickest way past these problems is to have more knowledgeable learners\n"
" help those who need it."
msgstr""
" the biggest stumbling block during the entire lesson:\n"
" many will try to run the same editor as the instructor\n"
" (which may leave them trapped in the awful nether hell that is Vim),\n"
" or will not know how to navigate to the right directory\n"
" to save their file,\n"
" or will run a word processor rather than a plain text editor.\n"
" The quickest way past these problems is to have more knowledgeable learners\n"
" help those who need it."
# unordered list
#:shell-novice/_extras/guide.md:143
msgid"* Introducing and navigating the filesystem in the shell (covered in"
msgstr"* Introducing and navigating the filesystem in the shell (covered in"
#:shell-novice/_extras/guide.md:144
msgid" [Navigating Files and Directories]({{ page.root }}/02-filedir/) section) can be confusing. You may have both terminal and GUI file explorer open side by side so learners can see the content and file structure while they're using terminal to navigate the system."
msgstr" [Navigating Files and Directories]({{ page.root }}/02-filedir/) section) can be confusing. You may have both terminal and GUI file explorer open side by side so learners can see the content and file structure while they're using terminal to navigate the system."
# unordered list
#:shell-novice/_extras/guide.md:146
msgid"* Tab completion sounds like a small thing: it isn't."
msgstr"* Tab completion sounds like a small thing: it isn't."
#:shell-novice/_extras/guide.md:147
msgid""
" Re-running old commands using `!123` or `!wc`\n"
" isn't a small thing either,\n"
" and neither are wildcard expansion and `for` loops.\n"
" Each one is an opportunity to repeat one of the big ideas of Software Carpentry:\n"
" if the computer *can* repeat it,\n"
" some programmer somewhere will almost certainly have built\n"
" some way for the computer *to* repeat it."
msgstr""
" Re-running old commands using `!123` or `!wc`\n"
" isn't a small thing either,\n"
" and neither are wildcard expansion and `for` loops.\n"
" Each one is an opportunity to repeat one of the big ideas of Software Carpentry:\n"
" if the computer *can* repeat it,\n"
" some programmer somewhere will almost certainly have built\n"
" some way for the computer *to* repeat it."
# unordered list
#:shell-novice/_extras/guide.md:155
msgid"* Building up a pipeline with four or five stages,"
msgstr"* Building up a pipeline with four or five stages,"
#:shell-novice/_extras/guide.md:156
msgid""
" then putting it in a shell script for re-use\n"
" and calling that script inside a `for` loop,\n"
" is a great opportunity to show how\n"
" \"seven plus or minus two\"\n"
" connects to programming.\n"
" Once we have figured out how to do something moderately complicated,\n"
" we make it re-usable and give it a name\n"
" so that it only takes up one slot in working memory\n"
" rather than several.\n"
" It is also a good opportunity to talk about exploratory programming:\n"
" rather than designing a program up front,\n"
" we can do a few useful things\n"
" and then retroactively decide which are worth encapsulating\n"
" for future re-use."
msgstr""
" then putting it in a shell script for re-use\n"
" and calling that script inside a `for` loop,\n"
" is a great opportunity to show how\n"
" \"seven plus or minus two\"\n"
" connects to programming.\n"
" Once we have figured out how to do something moderately complicated,\n"
" we make it re-usable and give it a name\n"
" so that it only takes up one slot in working memory\n"
" rather than several.\n"
" It is also a good opportunity to talk about exploratory programming:\n"
" rather than designing a program up front,\n"
" we can do a few useful things\n"
" and then retroactively decide which are worth encapsulating\n"
" for future re-use."
# unordered list
#:shell-novice/_extras/guide.md:171
msgid"* If everything is going well, you can drive home the point that file"
msgstr"* If everything is going well, you can drive home the point that file"
#:shell-novice/_extras/guide.md:172
msgid""
" extensions are essentially there to help computers (and human\n"
" readers) understand file content and are not a requirement of files\n"
" (covered briefly in [Navigating Files and Directories]({{ page.root }}/02-filedir/)).\n"
" This can be done in the [Pipes and Filters]({{ page.root }}/04-pipefilter/) section by showing that you\n"
" can redirect standard output to a file without the .txt extension\n"
" (e.g., lengths), and that the resulting file is still a perfectly usable text file.\n"
" Make the point that if double-clicked in the GUI, the computer will\n"
" probably ask you what you want to do."
msgstr""
" extensions are essentially there to help computers (and human\n"
" readers) understand file content and are not a requirement of files\n"
" (covered briefly in [Navigating Files and Directories]({{ page.root }}/02-filedir/)).\n"
" This can be done in the [Pipes and Filters]({{ page.root }}/04-pipefilter/) section by showing that you\n"
" can redirect standard output to a file without the .txt extension\n"
" (e.g., lengths), and that the resulting file is still a perfectly usable text file.\n"
" Make the point that if double-clicked in the GUI, the computer will\n"
" probably ask you what you want to do."
# unordered list
#:shell-novice/_extras/guide.md:181
msgid"* We have to leave out many important things because of time constraints,"
msgstr"* We have to leave out many important things because of time constraints,"
#:shell-novice/_extras/guide.md:182
msgid""
" including file permissions, job control, and SSH.\n"
" If learners already understand the basic material,\n"
" this can be covered instead using the online lessons as guidelines.\n"
" These limitations also have follow-on consequences:"
msgstr""
" including file permissions, job control, and SSH.\n"
" If learners already understand the basic material,\n"
" this can be covered instead using the online lessons as guidelines.\n"
" These limitations also have follow-on consequences:"
# unordered list
#:shell-novice/_extras/guide.md:187
msgid"* It's hard to discuss `#!` (shebang) without first discussing"
msgstr"* It's hard to discuss `#!` (shebang) without first discussing"
#:shell-novice/_extras/guide.md:188
msgid""
" permissions, which we don't do. `#!` is also [pretty\n"
" complicated][shebang], so even if we did discuss permissions, we\n"
" probably still wouldn't want to discuss `#!`."
msgstr""
" permissions, which we don't do. `#!` is also [pretty\n"
" complicated][shebang], so even if we did discuss permissions, we\n"
" probably still wouldn't want to discuss `#!`."
# unordered list
#:shell-novice/_extras/guide.md:192
msgid"* Installing Bash and a reasonable set of Unix commands on Windows"
msgstr"* Installing Bash and a reasonable set of Unix commands on Windows"
#:shell-novice/_extras/guide.md:193
msgid""
" always involves some fiddling and frustration.\n"
" Please see the latest set of installation guidelines for advice,\n"
" and try it out yourself *before* teaching a class."
msgstr""
" always involves some fiddling and frustration.\n"
" Please see the latest set of installation guidelines for advice,\n"
" and try it out yourself *before* teaching a class."
# unordered list
#:shell-novice/_extras/guide.md:197
msgid"* On Windows machines"
msgstr"* On Windows machines"
#:shell-novice/_extras/guide.md:198
msgid""
" if `nano` hasn't been properly installed with the\n"
" [Software Carpentry Windows Installer][windows-installer]\n"
" it is possible to use `notepad` as an alternative. There will be a GUI\n"
" interface and line endings are treated differently, but otherwise, for\n"
" the purposes of this lesson, `notepad` and `nano` can be used almost interchangeably."
msgstr""
" if `nano` hasn't been properly installed with the\n"
" [Software Carpentry Windows Installer][windows-installer]\n"
" it is possible to use `notepad` as an alternative. There will be a GUI\n"
" interface and line endings are treated differently, but otherwise, for\n"
" the purposes of this lesson, `notepad` and `nano` can be used almost interchangeably."
# unordered list
#:shell-novice/_extras/guide.md:204
msgid"* On Windows, it appears that:"
msgstr"* On Windows, it appears that:"
#:shell-novice/_extras/guide.md:206
msgid""
" ~~~\n"
" $ cd\n"
" $ cd Desktop\n"
" ~~~"
msgstr""
" ~~~\n"
" $ cd\n"
" $ cd Desktop\n"
" ~~~"
#:shell-novice/_extras/guide.md:212
msgid""
" will always put someone on their desktop.\n"
" Have them create the example directory for the shell exercises there\n"
" so that they can find it easily\n"
" and watch it evolve."
msgstr""
" will always put someone on their desktop.\n"
" Have them create the example directory for the shell exercises there\n"
" so that they can find it easily\n"
" and watch it evolve."
# unordered list
#:shell-novice/_extras/guide.md:217
msgid"* Stay within POSIX-compliant commands, as all the teaching materials do."
msgstr"* Stay within POSIX-compliant commands, as all the teaching materials do."
#:shell-novice/_extras/guide.md:218
msgid""
" Your particular shell may have extensions beyond POSIX that are not available\n"
" on other machines, especially the default OSX bash and Windows bash emulators.\n"
" For example, POSIX `ls` does not have an `--ignore=` or `-I` option, and POSIX\n"
" `head` takes `-n 10` or `-10`, but not the long form of `--lines=10`."
msgstr""
" Your particular shell may have extensions beyond POSIX that are not available\n"
" on other machines, especially the default OSX bash and Windows bash emulators.\n"
" For example, POSIX `ls` does not have an `--ignore=` or `-I` option, and POSIX\n"
" `head` takes `-n 10` or `-10`, but not the long form of `--lines=10`."
# header
#:shell-novice/_extras/guide.md:223
msgid"## Windows"
msgstr"## Windows"
#:shell-novice/_extras/guide.md:225
msgid""
"Installing Bash and a reasonable set of Unix commands on Windows\n"
"always involves some fiddling and frustration.\n"
"Please see the latest set of installation guidelines for advice,\n"
"and try it out yourself *before* teaching a class.\n"
"Options we have explored include:"
msgstr""
"Installing Bash and a reasonable set of Unix commands on Windows\n"
"always involves some fiddling and frustration.\n"
"Please see the latest set of installation guidelines for advice,\n"
"and try it out yourself *before* teaching a class.\n"
"Options we have explored include:"
# ordered list
#:shell-novice/_extras/guide.md:231
msgid"1. [msysGit](http://msysgit.github.io/) (also called \"Git Bash\"),"
msgstr"1. [msysGit](http://msysgit.github.io/) (also called \"Git Bash\"),"
# ordered list
#:shell-novice/_extras/guide.md:232
msgid"2. [Cygwin](http://www.cygwin.com/),"
msgstr"2. [Cygwin](http://www.cygwin.com/),"
# ordered list
#:shell-novice/_extras/guide.md:233
msgid"3. using a desktop virtual machine, and"
msgstr"3. using a desktop virtual machine, and"
# ordered list
#:shell-novice/_extras/guide.md:234
msgid"4. having learners connect to a remote Unix machine (typically a VM in the cloud)."
msgstr"4. having learners connect to a remote Unix machine (typically a VM in the cloud)."
#:shell-novice/_extras/guide.md:236
msgid""
"Cygwin was the preferred option until mid-2013,\n"
"but once we started teaching Git,\n"
"msysGit proved to work better.\n"
"Desktop virtual machines and cloud-based VMs work well for technically sophisticated learners,\n"
"and can reduce installation and configuration at the start of the workshop,\n"
"but:"
msgstr""
"Cygwin was the preferred option until mid-2013,\n"
"but once we started teaching Git,\n"
"msysGit proved to work better.\n"
"Desktop virtual machines and cloud-based VMs work well for technically sophisticated learners,\n"
"and can reduce installation and configuration at the start of the workshop,\n"
"but:"
# ordered list
#:shell-novice/_extras/guide.md:243
msgid"1. they don't work well on underpowered machines,"
msgstr"1. they don't work well on underpowered machines,"
# ordered list
#:shell-novice/_extras/guide.md:244
msgid"2. they're confusing for novices (because simple things like copy and paste work differently),"
msgstr"2. they're confusing for novices (because simple things like copy and paste work differently),"
# ordered list
#:shell-novice/_extras/guide.md:245
msgid"3. learners leave the workshop without a working environment on their operating system of choice, and"
msgstr"3. learners leave the workshop without a working environment on their operating system of choice, and"
# ordered list
#:shell-novice/_extras/guide.md:246
msgid"4. learners may show up without having downloaded the VM or the wireless will go down (or become congested) during the lesson."
msgstr"4. learners may show up without having downloaded the VM or the wireless will go down (or become congested) during the lesson."
#:shell-novice/_extras/guide.md:248
msgid""
"Whatever you use,\n"
"please *test it yourself* on a Windows machine *before* your workshop:\n"
"things may always have changed behind your back since your last workshop.\n"
"And please also make use of our\n"
"[Software Carpentry Windows Installer][windows-installer]."
msgstr""
"Whatever you use,\n"
"please *test it yourself* on a Windows machine *before* your workshop:\n"
"things may always have changed behind your back since your last workshop.\n"
"And please also make use of our\n"
"[Software Carpentry Windows Installer][windows-installer]."
Translation: shell-novice Extras "Guide" (guide.md)
i18n/po/shell-novice.ja.po
Lines 11362 to 12028 in f4aed5e
The text was updated successfully, but these errors were encountered: