added useful features to getting started section

Author: dr-matt-smith

.DS_Store

@@ -13,4 +13,4 @@ dependencies = [
 ]
 
 [celbridge]
-version = "0.1.4.0"
+celbridge-version = "0.2.0"

celbridge-docs.celbridge

@@ -0,0 +1,9 @@
+{
+  "_entityVersion": 1,
+  "_components": [
+    {
+      "editorMode": "Editor",
+      "_type": "Markdown.Markdown#1"
+    }
+  ]
+}

celbridge/.DS_Store

@@ -0,0 +1,9 @@
+{
+  "_entityVersion": 1,
+  "_components": [
+    {
+      "editorMode": "Editor",
+      "_type": "Markdown.Markdown#1"
+    }
+  ]
+}

celbridge/entities/docs/03_getting_started/examples.md.json

@@ -75,9 +75,11 @@ It also offers a range of commands for running CLI programs, available using the
 
 ### IPython built-in "magic" `%` commands
 
-IPython offers a range of commands for running CLI programs, available using the percent "`%`" character. Examples including:
+IPython offers a range of commands for running CLI programs, available using the percent "`%`" character. Automagic mode is switched on by default, so in almost all cases you can omit the percent "`%`" character, since IPython will saerch its list of magic commands to match against what you have typed.
 
-1. Print Working Direcotry (`pwd`):
+Examples including:
+
+1. Print Working Direcotry (`%pwd` or `pwd`):
 
    > ```
    > >>> %pwd
@@ -87,7 +89,7 @@ IPython offers a range of commands for running CLI programs, available using the
    > ```
 
 
-1. Change Direcotry (`cd`):
+1. Change Direcotry (`%cd` or `cd`):
 
    > ```
    > >>> %pwd
@@ -102,10 +104,38 @@ IPython offers a range of commands for running CLI programs, available using the
    > >>>
    > ```
 
+1. History of terminal commands (`%history` or `history`)
+
+   > ```
+   > >>> history
+   > pwd
+   > cd docs
+   > !make clean
+   > !make html
+   > !python3 -m http.server 8000 --directory _build\html
+   > history
+   > ```
 
 The IPython documentation pages provide
 a [full list of the magic commands](https://ipython.readthedocs.io/en/stable/interactive/magics.html)
 
+### IPython `.ipy` files
+
+If there are several commands you often type in the same sequence, or have commands with many arguments, you can type those commands into a text file with the `.ipy` extension, and then run the sequence of commands in that file at the terminal with:
+
+   > ```
+   > >>> run <filename>.ipy
+   > ```
+
+For example, when working with Sphinx I often wish to run `!make clean` immediately before running `!make html`. So I could create a file `make.ipy` containing these commands:
+
+   > ```
+   > !make clean
+   > !make html
+   > ```
+
+And then I can run them by entering `run make.ipy` in the console.
+
 
 Learn more about REPLs and this console at:
 

celbridge/entities/docs/03_getting_started/useful_features.md.json

@@ -3,7 +3,10 @@
 Each Celbridge release includes an example project that demonstrates the core features of Celbridge. Access this example project as follows:
 
 1. Launch Celbridge.
-2. From the home menu, click `New example project`.
+2. From the home menu, click `New project`.
+3. Select eh Examples template.
+4. Choose a suitable folder and project name.
+5. Click Create.
 
 :::{note}
 If an existing project opens instead of the home menu, click the home button in the navigation bar to the left of the explorer panel.
@@ -13,7 +16,14 @@ If an existing project opens instead of the home menu, click the home button in
 4. Celbridge will generate a new example project. Each folder in this project contains an example of a core feature of Celbridge. For example, the `01_markdown` folder demonstrates how to work with Markdown files.
 5. To get started with each feature, see the `readme.md` files contained in the example folders.
 
-```{image} /images/new_examples_project.png
+```{image} /03_getting_started/images/examples.png
 :alt: Screenshot showing Python version and extensions in .celbridge configuration
 :  file
 ```
+
+You should now have a proejct with several examples, each in their own directories:
+```{image} /03_getting_started/images/new_examples_project.png
+:alt: Screenshot showing Celbridge project containing examples
+:  file
+```
+