Login

The Toolbox is currently being upgraded to a new version with easier editing (November-December 2018). This information may be outdated.

 

Here you can find an outline about the Dr Toolbox page structure and editing interface.

 

See also: Editing, Promotional material downloads, Implementation Guide.

Expand all Minimise all  

Page Title

The page title is the large heading that appears near the top of the page.

 

By default, the title is derived from the page name, but you can modify it: click on the "Edit" link right after the title, then type the new title in the text field, and press "Save title". The page title will appear when you link to that page from other pages, or from the SideBar.

 

Changing the page title does not move the page to a different name. For example a page can have the name "Telephones" and the title "Telephones & Bleeps". Once you change the title of a page, most links to that page in other pages, or in the SideBar, will be updated to the new title.

Editing: section heading

You can modify the section heading in the edit form: simply click in the text field and change it. The heading can be of level 1 or 2 (subheading, subsection): check the checkbox to make it level 2.

 

When the sections are closed (collapsed, minimized), only the headings are visible. Short but descriptive headings may be most useful to readers.

Editing: list of links

Below there are 4 tabs for the link widgets:

 

New contact allows you to add directory entries, usually to the page "Telephones/Bleeps". Type the name or function of the person or service, then fill as many fields as needed with telephone/extension numbers, bleep or fax numbers, e-mail or website addresses. Then press "Add contact".

 

If you have more numbers to add, for example there are more than 2 extensions, just start over. The "Name" field will not be cleared so you don't need to retype it. To clear the "Name" field click on "Clear form".

 

Attached file will insert a link to a file uploaded to your toolbox. Select the file from the drop-down menu. Type the text of the link if you like, then press "Add link".

 

To upload new files, follow the link at the bottom of the widget. After a file is uploaded, it will appear in the drop-down list.

 

Page link will insert a link to an existing page in your toolbox, or to a new page that needs to be created.

 

To link to an existing page, select it from the drop-down menu then press "Add link".

 

To link to a new page, type its name and press "Add link". See the section "How to create a page" below.

 

External link will help you insert links to external websites or pages, and to e-mail addresses. Place the link URL address in the first text field. Place the text of the link in the second. Press on "Add link".

Advanced editing operations

How to create a new page, how to edit the SideBar, how to delete a page...

Advanced editing: numbered, bulleted, nested lists

Bulleted lists

To create a bulleted list, start every line with an asterisk * (star):

  • Here is a bulleted list.
  • Another list item.
     

Numbered lists

To create a numbered list, start every line with a hash #:

  1. First item (line starts with #).
  2. Second item (line starts with #).
  3. If you reorder, insert or delete items later, the numbers will be automatically updated.
     

Nested lists

It is possible to have nested lists: use 2 asterisks or 2 hashes (or more) as start of line:

  1. This is list of level 1 (starts with #).
  2. Another item level 1 (starts with #).
    • Item of level 2 (starts with **)
    • Another one (starts with **).
  3. Back to level 1 (starts with #). The numbering continues from where it was.
    1. Nested numbered list (starts with ##)
    2. Another item (starts with ##)
      • Third level, use sparingly (starts with ***).
         

Like the paragraphs, list items can also have bold text and links.

How to configure a telephone prefix for dialling extensions

Please see the page How to set a telephone prefix.

How to change the "Contact e-mail" address

The "Contact e-mail address" receives messages from users who report problems or suggest updates to specific pages.

 

To change it, go to the HomePage of your toolbox, then edit the address in the "Contact e-mail" text field.

 

All toolboxes must have a contact e-mail. If your team does not have one yet, you can temporarily assign our support e-mail (support [snail] dr-toolbox [period] com).

How to view the page history, and restore a previous version

The wiki software stores all previous versions of a page and allows a previous version to be reviewed and restored.

 

Sometimes we need to know who added a piece of text and when. To display the page history, follow the link "history" below the page header (only editors can see the page history). You will see a list of edits with lines added, modified or deleted, with the date/time stamp and the name of the author.

 

To restore a version:

  • click on the "Restore" link below the history entry,
  • the advanced editing text area will appear, with a preview of the previous version below,
  • press "Save" to save the page.
     

If you have any difficulty do not hesitate to contact us -- we can and will restore a previous version of a page for you.

How to create a new page

To create a new page, add a link to it in an existing page. Save the existing page, then click on the link which will take you to the new page.

 

Start by creating the page summary, save it, then create the sections.

How to see which pages were recently modified

Click on the "review" link between the page header and the page title (for editors).

 

Alternatively: open the special page www.dr-toolbox.com/XYZ/RecentChanges where XYZ is the domain of your toolbox.

 

You will see a table with all pages alphabetically with the dates when each have been last modified and reviewed.

 

Below the table, there is a list of links to recently modified pages, each line containing the page name, the date-time for the latest change, and the account of the user who made the change. Clicking on the page name will open the page; clicking on the time stamp will open the page history; clicking on the username will open her/his profile page.

How to edit the Side Bar

The SideBar is a special page in your toolbox which is included in all other pages. To edit it, click on the "Edit SideBar" link near the middle of the SideBar, after the toolbox links and before the app buttons.

 

Alternatively, navigate to the address www.dr-toolbox.com/XYZ/SideBar where XYZ is your toolbox domain. Note the capitalization for "SideBar".

 

We love innovation, but keep the general format and most headings the same so doctors aren't too thrown after changing hospitals and looking for similar information.

How to delete a page

To delete a page, open for editing the very first "Page summary" section (click on "edit", or "Edit page summary", or "Add page summary"), then press on the red "Delete page" button.

 

Screenshot

 

After this, a special page will appear with a message that the page doesn't exist, a link to create it and a list of "backlinks" (pages linking to this page). Please edit all these pages to remove any links that point to the deleted page.

 

A "deleted" page is only hidden from the website and apps, but we can restore it, with the full edit history, in case the deletion was a mistake.

 

Alternative way to delete a page

This is an advanced operation.

 

  1. Click on the "code" link to open the page in advanced editing mode.
  2. Make sure there is a frame containing "No backlinks" above the edit form.
    • If there are links to that page in other pages, please edit the other pages to remove or correct these links.
  3. Delete the page title from the text field.
  4. Replace all the code in the large text area with the word "delete" (without the quotes).
  5. In the "Summary:" field, type the reason for the deletion, eg. "Created by mistake" or "No longer needed".
  6. Press "Save".
     

Screenshot

Top tips

Do not fear editing, all changes are monitored and can be restored from a previous version in case of a mistake.

 

Write in a concise manner: many of your users will read the pages on their mobile phones, and will probably be in a hurry.

 

Enable the spell checker in your browser for English (UK), then fix any spelling, grammar, punctuation and typography errors you notice. For example most sentences should start with a capital letter and end with a fullstop. A text without errors is easier to read, looks nicer and more professional, and makes the reader's experience more pleasant.

 

If a page becomes too large (like this one), consider splitting it into a few smaller pages with links between them.

 

If a section or sections are repeated/reused in more than one page, it may be sensible to write them in their own page then link to it in every other page. This makes it easier to update the content: you only need to update it once.

 

Use the link widgets, especially for the Telephones/Bleeps pages, this allows for easier searching and filtering. Also, these listings are specifically formatted on a mobile phone to be easy to tap with your fingers and dial.

 

The internal search cannot search within uploaded files or external links. If the information should be available for search and for offline reading on mobile devices, write it in a page rather than uploaded as a file, or to Dropbox/Google Docs or other.

 

Additional punctuation for links, bold text and numbered/bulleted lists can be easily abused: use it sparingly. This will keep your pages easy to update by newcomers.

 

It is often possible to have simple paragraphs instead of bulleted lists: easier to type and on a tiny phone screen more of the content can be seen at once.

 

All editors have personal profile pages. To see and edit your profile, follow the "Edit profile" red link in the page footer. Other editors can visit your profile when they look at RecentChanges or at a page history.

 

If you have any difficulty, or notice a bug, or have an idea for improvement, or need something specific for your toolbox domain, tell us -> mailto:support [snail] dr-toolbox [period] com!