_pub.n

• 2.1 Create a notebookhttp://www.noteshare.io/section/asciidoc-101?part=Create%20a%20notebook#_create_a_notebook
• 2.2 Create a new sectionhttp://www.noteshare.io/section/asciidoc-101?part=Create%20a%20new%20section#_create_a_new_section
• 2.3 Imageshttp://www.noteshare.io/section/asciidoc-101?part=Images#_images
• 2.4 Manage notebookhttp://www.noteshare.io/section/asciidoc-101?part=Manage%20notebook#_manage_notebook
• 2.5 Collaborationhttp://www.noteshare.io/section/asciidoc-101?part=Collaboration#_collaboration
• 2.6 Exporthttp://www.noteshare.io/section/asciidoc-101?part=Export#_export
• 3.1 First things firsthttp://www.noteshare.io/section/markup-basics?part=First%20things%20first#_first_things_first
• 3.2 Sectionshttp://www.noteshare.io/section/markup-basics?part=Sections#_sections
• 3.3 Blockshttp://www.noteshare.io/section/markup-basics?part=Blocks#_blocks
• 3.4 Basic tableshttp://www.noteshare.io/section/markup-basics?part=Basic%20tables#_basic_tables
• 4.5 Math Homeworkhttp://www.noteshare.io/section/math-homework?part=Math%20Homework#_math_homework
• 4.6 Chemistryhttp://www.noteshare.io/section/math-homework?part=Chemistry#_chemistry
• 6.1 Creating a Notehttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Creating%20a%20Note#_creating_a_note
• 6.2 Editing a Notehttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Editing%20a%20Note#_editing_a_note
• 6.3 Markup 102http://www.noteshare.io/section/creating-notes-and-notebooks?part=Markup%20102#_markup
• 6.4 Creating a notebookhttp://www.noteshare.io/section/creating-notes-and-notebooks?part=Creating%20a%20notebook#_creating_a_notebook
• 7.1 A simple tablehttp://www.noteshare.io/section/tables-?part=A%20simple%20table#_a_simple_table
• 7.2 A formatted tablehttp://www.noteshare.io/section/tables-?part=A%20formatted%20table#_a_formatted_table
• 8.1 References within a notehttp://www.noteshare.io/section/cross-references-2?part=References%20within%20a%20note#_references_within_a_note
• 8.2 References within Notesharehttp://www.noteshare.io/section/cross-references-2?part=References%20within%20Noteshare#_references_within_noteshare
• 8.3 References to a web pagehttp://www.noteshare.io/section/cross-references-2?part=References%20to%20a%20web%20page#_references_to_a_web_page
• 8.4 References to something inside a web pagehttp://www.noteshare.io/section/cross-references-2?part=References%20to%20something%20inside%20a%20web%20page#_references_to_something_inside_a_web_page
• 9.1 Syntaxhttp://www.noteshare.io/section/mathematical-notation?part=Syntax#_syntax
• 10.1 Exampleshttp://www.noteshare.io/section/chemistry?part=Examples#_examples
• 10.2 Structural formulashttp://www.noteshare.io/section/chemistry?part=Structural%20formulas#_structural_formulas
• 10.3 Referenceshttp://www.noteshare.io/section/chemistry?part=References#_references
• 14.1 Check-in and check-outhttp://www.noteshare.io/section/collaboration?part=Check-in%20and%20check-out#_check_in_and_check_out
• 15.1 Attributeshttp://www.noteshare.io/section/extras?part=Attributes#_attributes
• 16.1 Notes on the embed featurehttp://www.noteshare.io/section/test-of-embed-feature?part=Notes%20on%20the%20embed%20feature#_notes_on_the_embed_feature
• 20.1 Problem sets, etc.http://www.noteshare.io/section/technical-appendix?part=Problem%20sets,%20etc.#_problem_sets_etc
• 20.2 Quiz #1http://www.noteshare.io/section/technical-appendix?part=Quiz%20#1#_quiz
• 20.3 Quiz #2http://www.noteshare.io/section/technical-appendix?part=Quiz%20#2#_quiz
• 20.4 Technical notehttp://www.noteshare.io/section/technical-appendix?part=Technical%20note#_technical_note
• 22.1 Why Markup?http://www.noteshare.io/section/asciidoc-markup?part=Why%20Markup?#_why_markup
• 22.2 PDFhttp://www.noteshare.io/section/asciidoc-markup?part=PDF#_pdf
• 22.4 More Asciidoc Exampleshttp://www.noteshare.io/section/asciidoc-markup?part=More%20Asciidoc%20Examples#_more_asciidoc_examples

# Noteshare Handbook


## 2. Working with notebooks

Figure 1. Editing Panel

This section describes how to use the tools for creating, editing, and managing notebooks. If you click on the title of one of the notebooks listed on your home page, you will be led to a page which displays the editor control panel. It should look roughly like the control panel in Figure 1. For a short description of what a button does, mouse over it. For a longer description, click on the help tool .

In what follows, we group the buttons by function — creating a notebook, creating a section, adding an image, etc. The first two are essential, while the remaining ones can be studied at your leisure.

### 2.1. Create a notebook

To create a notebook and edit its first section, you will need to know how to use just four buttons.

Create

Go the home page and click on to create a document. Fill out the form and press Create. You will be led a page with the controls as displayed in the figure elow.

Edit

The controls for editing a document are displayed in Figure 1 above. Click on to edit the current section.

Update

If you are editing text for the current section, click on to update and save it. The key command Ctrl-U has the same effect.

Exit

Click on to exit the editor window without saving. The key command Ctrl-X has the same effect.

### 2.2. Create a new section

To create a new section of a notebook, then publish or share it, use the buttons listed below.

New section

Click on and fill out the form. In the form there is a check box labeled "Attach PDF". Check it if you want to upload a PDF file, and then follow directoins.

Publish

Click on to make the current section public. Click on it again to make it private. If the section is public, the background is green. Anyone can view a public section. Cllick on to make all sections of the current notebook public. Click on it again to make all sections private.

Share

Click on to share a section with someone by email.

 Tip Mouse over a button in the Editing Panel to view a short description of what it does.

### 2.3. Images

Click on to upload an image. Fill out the form, choose the image, then press Upload. When the upload is complete, note the ID of the image. For instance, if the ID is 632, you can place an image in your document with image ::632[] or image ::632[width=200].

For audio, use the same button but write the link as audio ::632[]. For video it is best to link to YouTube or vimeo. See Adding Video in this manual.

### 2.4. Manage notebook

Tags, Summary

Click on to edit the section summary or its search tags.

Change title

Click on to change the title of a notebook or to edit its search tags.

Change order of sections

Click on to change the order of the section of a notebook.

Delete section

Click on to delete a section. This operation cannot be undone. You will be asked to confirm your choice.

### 2.5. Collaboration

Comment

If the author of a document allows comments on it, the comment tool will be displayed. Click on it to add a comment. The comment must be of the form

```[comment]
--
BODY OF COMMENT
--```

To ensure that your comment will be posted, do not modify the text upon which you comment. Your user name and the date will be included with the comment.

Checkout

Click on to check a section out. Click it again to check the section back in. When a section is checked out, only the person to whom it is checked out can edit it. This feature is useful for collaborative writing and editing projects.

Make includable:

When a section is "includable", part or all of a section may be included in another document. Click on to permit inclusion. Click it again to forbid inclusion. A section that is includable displays hte include tool with a light green background. See the May, 2015 newsletter to see how this feature works.

### 2.6. Export

Export

Click on to export an entire notebook. See the June, 2015 Newsletter for details on how this is done and for a description of what the download includes.

Created August 21, 2015, last updated: September 16, 2015