getting-started-sagenotebook.rst
changeset 168 13280334ca2b
child 169 0b0620ae8f4d
equal deleted inserted replaced
167:f22530911c51 168:13280334ca2b
       
     1 Hello friends. Welcome to this spoken tutorial on Getting started with
       
     2 sage and sage notebook.
       
     3 
       
     4 {{{ Show the slide containing the title }}}
       
     5 
       
     6 {{{ Show the slide containing the outline }}}
       
     7 
       
     8 In this tutorial, we will learn what Sage is, what is Sage notebook,
       
     9 how to start and use the sage notebook. In the notebook we will be
       
    10 specifically learning how to execute our code, how to write
       
    11 annotations and other content, typesetting the content and how to use
       
    12 the offline help available.
       
    13 
       
    14 {{{ Show the slide on what is Sage }}}
       
    15 
       
    16 To start with, What is Sage? Sage is a free, open-source mathematical
       
    17 software. Sage can do a lot of math stuff for you including but not
       
    18 limited to algebra, calculus, geometry, cryptography, graph theory
       
    19 among other things. It can also be used as aid in teaching and
       
    20 research in any of the areas that Sage supports. So let us start Sage
       
    21 now
       
    22 
       
    23 {{{ Shift to terminal }}}
       
    24 
       
    25 We are assuming that you have Sage installed on your computer now. If
       
    26 not please visit the page
       
    27 http://sagemath.org/doc/tutorial/introduction.html#installation for
       
    28 the tutorial on how to install Sage. Let us move on now.
       
    29 
       
    30 On the terminal type::
       
    31 
       
    32   sage
       
    33 
       
    34 This should start a new Sage shell with the prompt sage: which looks
       
    35 like this
       
    36 
       
    37 {{{ Show what is displayed on the terminal }}}
       
    38 
       
    39 So now we can type all the commands that Sage supports here. But Sage
       
    40 comes bundled with a much much much more elegant tool called Sage
       
    41 Notebook? What is Sage Notebook? Sage Notebook provides a web based
       
    42 user interface to use Sage. So once we have a Sage notebook server up
       
    43 and running all we want is a browser to access the Sage
       
    44 functionality. For example there is an official instance of Sage
       
    45 Notebook server running at http://sagenb.org You can visit that page,
       
    46 create an account there and start using Sage! So all you need is just
       
    47 a browser, a modern browser 
       
    48 
       
    49 {{{ Intentional *cough* *cough* }}}
       
    50 
       
    51 to use Sage and nothing else!
       
    52 
       
    53 However we can also run our own instances of Sage notebook servers on
       
    54 all the computers we have a local installation of Sage. To start the
       
    55 notebook server just type::
       
    56 
       
    57   notebook()
       
    58 
       
    59 on the Sage prompt. This will start the Sage Notebook server.
       
    60 If we are starting the notebook server for the first time, we are
       
    61 prompted to enter the password for the admin. Type the password and
       
    62 make a note of it. After this Sage automatically starts a browser page
       
    63 for you with the notebook opened.
       
    64 
       
    65 If it doesn't automatically start a browser page check if the Notebook
       
    66 server started and there were no problems. If so open your browser and
       
    67 in the address bar type the URL shown in the instructions upon running
       
    68 the notebook command on the sage prompt.
       
    69 
       
    70 {{{ The notebook() command gives an instruction telling 
       
    71 Open your web browser to http://localhost:8000. Point towards it }}}
       
    72 
       
    73 In our case it is http://localhost:{{{ Tell whatever is shown }}}
       
    74 
       
    75 {{{ Show the browser with Sage notebook }}}
       
    76 
       
    77 If you are not logged in yet, it shows the Notebook home page and
       
    78 textboxes to type the username and the password. You can use the
       
    79 username 'admin' and the password you gave while starting the notebook
       
    80 server for the first time. There are also links to recover forgotten
       
    81 password and to create new accounts.
       
    82 
       
    83 {{{ If you are logged in tell that you are logged in, log out and show
       
    84 what is said above for the login page }}}
       
    85 
       
    86 Once we are logged in with the admin account we can see the notebook
       
    87 admin page. A notebook can contain a collection of Sage Notebook
       
    88 worksheets. Worksheets are basically the working area. This is where
       
    89 we enter all the Sage commands on the notebook.
       
    90 
       
    91 The admin page lists all the worksheets created. On the topmost part
       
    92 of this page we have the links to various pages. The home link takes
       
    93 to the admin home page. The published link takes us the page which
       
    94 lists all the published worksheets.
       
    95 
       
    96 
       
    97 
       
    98 
       
    99 This brings us to the end of the session on using Sage notebook. In
       
   100 this tutorial session we learnt
       
   101 
       
   102   *
       
   103 
       
   104 {{{ Show the "sponsored by FOSSEE" slide }}}
       
   105 
       
   106 This tutorial was created as a part of FOSSEE project, NME ICT, MHRD India
       
   107 
       
   108 Hope you have enjoyed and found it useful.
       
   109 Thankyou
       
   110  
       
   111 .. Author              : Madhu
       
   112    Internal Reviewer 1 :         [potential reviewer: Anoop]
       
   113    Internal Reviewer 2 :         [potential reviewer: Puneeth]
       
   114    External Reviewer   :
       
   115