Team Basic: Adding openshell and commands man, open, say

git-svn-id: svn+ssh://atelier.inf.usi.ch/home/bevilj/group-1@73 a672b425-5310-4d7a-af5c-997e18724b81
This commit is contained in:
devitg 2018-11-09 13:06:37 +00:00
parent 008962d600
commit fb32671ef3
4 changed files with 231 additions and 0 deletions

View File

@ -0,0 +1,34 @@
---
layout: page
category_title: Basic commands
category-page: basic
tags: manual
author: De Vita Gianmarco
title: man
---
<p>The <code>man</code> tool allows you to explore the various utilities
of the Shell. To search for more information about a command, just write</p>
<pre>
Device-name:Current-position username$ man command-name
</pre>
<p>As result, a new session will be opened with information about the command
you have typed (and more specifically about its functions and flags).</p>
<p>Using some flags, you can obtain with this command the same results you get
when you use other commands. For istance:</p>
<h3>The <code>-k</code> flag</h3>
<p>Using the <code>-k</code> flag, you obtain an equivalent result to
<code>apropos</code>.</p>
<pre>
Device-name:Current-position username$ man -k command-name
</pre>
<h3>The <code>-f</code> flag</h3>
<p>Using the <code>-f</code> flag, you obtain an equivalent result to
<code>whatis</code>.</p>
<pre>
Device-name:Current-position username$ man -f command-name
</pre>

View File

@ -0,0 +1,76 @@
---
layout: page
author: De Vita Gianmarco
title: OPEN
---
<p>You can open files and folder as new windows through the terminal.
The command is <code>open</code>. By writing the command open followed by the
path and the name of the file (remember that you can omit the path if
the file is in the current position), a new window in the common user
interface opens. Now you can work on the opened file.
</p>
<pre>
Device-name:Current-position username$ open path/name-file
</pre>
<h3>Open a file with a specific application</h3>
<p>Adding the flag <code>-a</code> to the command permit you to decide with
which specific application open the file. Just write the flag followed by the
name of the application.
</p>
<pre>
Device-name:Current-position username$ open -a application-name path/name-file
</pre>
<h4>Example</h4>
<p>Assume that I want to open with <i>Preview</i> the file
<code>abc.pdf</code> on my Desktop.
I have to write:
</p>
<pre>
User-Device:~ user$ open -a preview Desktop/abc.pdf
</pre>
<p>As result, a new <i>Preview</i> window appears in pop up showing the content of the
chosen file.
</p>
<h3>Open a file with <i>TextEdit</i></h3>
<p>If you want to open a file with TextEdit, just use instead of <code>-a</code>
the flag <code>-e</code> and write the path and the name of the file you want
to open.</p>
<pre>
User-Device:~ user$ open -e Desktop/text.txt
</pre>
<h3>Open the folder which contains the file</h3>
<p>If you want to open the folder that contains a specific file, just use
the flag <code>-R</code> and write the path and the name of the file you want to open.
</p>
<pre>
User-Device:~ user$ open -R Desktop/text.txt
</pre>
<p>As result, a new <i>Finder</i> window opens the folder displaying its content.</p>
<h3>Open a file as a text</h3>
<p>If you want to open a file with your default text editor (determined via
LaunchServices), just use the flag <code>-t</code> and write the path and the name of
the file you want to open.</p>
<pre>
User-Device:~ user$ open -t Desktop/text.txt
</pre>
<h3>Visit a Website</h3>
<p>You can use this tool not only to open files and folders, but also webpages.
Just write the command <code>open</code> followed by the <code>URL</code> of the page
you want to visit. For example, by typing the command</p>
<pre>
User-Device:~ user$ open http://www.google.com
</pre>
<p>A new page of your default browser will open on the indicated page (in this
example, the main page of the Google Search Engine). </p>

View File

@ -0,0 +1,50 @@
---
layout: page
author: De Vita Gianmarco
title: Open the Shell
---
<p>The tool that allows us to interact with the system with the shell is the terminal.
There are mainly two ways to access to the terminal on a MacOS system.</p>
<h3>Through the Finder</h3>
<ol>
<li>Open a new <i>Finder</i> window by clicking on the icon on the system dock.</li>
<img src="" alt="Open Finder" height="">
<li>On the menu bar, click on <i>Go</i>.</li>
<img src="" alt="Click on Go" height="">
<li>Click on <i>Utilities</i>.</li>
<img src="" alt="Click on Utilities" height="">
<li>Look for <i>Terminal</i> and click on it.</li>
<img src="" alt="Open Terminal" height="">
</ol>
<h3>Through <i>Spotlight</i></h3>
<ol>
<li>You can use the shortcut <code>cmd+space</code> to access to <i>Spotlight</i>.</li>
<img src="" alt="Access to Spotlight" height="">
<li>Then search for <i>Terminal</i>.</li>
<img src="" alt="Search Terminal" height="">
<li>Click on the <i>Terminal</i> icon displayed as result.</li>
<img src="" alt="Open Terminal" height="">
</ol>
<p>As you open the Terminal, a new blank window opens: </p>
<img src="" alt="Terminal Blank Window" height="">
<p> You can notice that the top lines in the window follow this structure:</p>
{% highlight ruby linenos %}
Last login: Day Month 2 hh:mm:ss on console
Device-name:~ username$
{% endhighlight %}
<p>The tilde (~) just before your username means that the current position in
which the terminal is working is the Home directory. The gray spot next to
the symbol $ after your username indicates that you can write instructions
in that space.</p>
<p>Now, you are ready to try and use some simple commands
to familiarize with this interface.</p>
<p>Notice that you can work simultaneously on multiple sessions of the Terminal.
Just by pushing <code>cmd+T</code>, a new blank window will open without closing the current.</p>

View File

@ -0,0 +1,71 @@
---
layout: page
author: De Vita Gianmarco
title: SAY
---
<p>You can convert text into audible speech just by writing the command
<code>say</code> followed by a string. This is possible thanks to the
Speech Synthesis manager.</p>
{% highlight ruby linenos %}
Device-name:Current-position username$ say string
{% endhighlight %}
<p>Naturally, the wide presence of flags for this command allows you to use
this command for many different tasks. Notice that using more flag
simultaneously, you will be able to solve more complex operations.</p>
<h3>Read a particular file</h3>
<p>By writing the command followed by the flag <code>-f</code> and, instead
of the string, by the path of a text file, you will get as output a voice
reading the content of that file.</p>
{% highlight ruby linenos %}
Device-name:Current-position username$ say -f path/text.txt
{% endhighlight %}
<h3>Specify the reading voice</h3>
<p>By writing the flag <code>-v</code> followed by a person name and a string, you
can decide which voice should read the string.</p>
{% highlight ruby linenos %}
Current-position username$ say -v name string
{% endhighlight %}
<p><b>Notice.</b> Of course, you're not expected to know every possible voice,
so, by writing "?" as argument of the command (including also the flag -v),
you will get a list of all the available voices.</p>
{% highlight ruby linenos %}
Current-position username$ say -v ?
{% endhighlight %}
<h3>Specify the Speech Rate</h3>
<p>By writing the flag <code>-r</code> followed by a rate and then by a
string, you can decide the reading speed in words per minute.</p>
{% highlight ruby linenos %}
Current-position username$ say -r rate string
{% endhighlight %}
<h3>Store the output in an audible file</h3>
<p>You can save the result of the command in an audible file. To do that,
you have just to write after the command the flag <code>-o</code> followed
by the path/name of the output file and then the string that has to be read.</p>
{% highlight ruby linenos %}
Current-position username$ say -o path/audiofile.*format string
{% endhighlight %}
<h3>Exercise - Flags combinations</h3>
<p>As said above, you can use more flags in the same command, once you know
well them. See the examples below and try to guess the output. You can
copy these commands into your terminal to verify your answers.</p>
{% highlight ruby linenos %}
Current-position username$ say -v Alex -f hello_world.txt
{% endhighlight %}
{% highlight ruby linenos %}
Current-position username$ say -o hi.aac -f hello_world.txt
{% endhighlight %}