Tags:
create new tag
, view all tags

Electronic Log Book Help

Creating a new log book

  1. The Logbook software should be installed in the web you wish to create the log book in. If not please contact the Physics TWiki admins.
  2. Choose a unique name for the logbook, for example Mydata.
  3. Enter it into the form below and click the "Create Logbook" button.
  4. Add any other titling etc. information you want the logbook to have in the resultant edit window and click Save when done. Choosing between the default WYSIWYG and RAW editors can also be done here.
  5. The logbook should now be ready to use.
New topic

Accessing the logbook

Adding entries to the logbook

  1. Click New topic Add Entry to navigate to the form at the bottom of the page.
  2. Fill in the Subject field to summarise/identify the new entry.
  3. Select a suitable item from the Status pull-down menu to reflect state of the entry. Most items are self-explanatory. The bar_*pc items produce 0%, 20%, 40%, 60%, 80% & 100% filled progress bars to reflect the stages of an on-going project.
    The full list is; blank Blank box, choice-no No, choice-yes Yes / Done, closed CLOSED, bar_0pc Bar_0pc, bar_20pc Bar_20pc, bar_40pc Bar_40pc, bar_60pc Bar_60pc, bar_80pc Bar_80pc, bar_100pc Bar_100pc, done DONE, info Info, led-aqua Aqua led, led-blue Blue led, led-gray Gray led, led-green Green led, led-orange Orange led, led-purple Purple led, led-red Red led, led-yellow Yellow led, new NEW, processing Processing, question Question, remove Remove button, small, stargold Gold star, favorites, starred Red star, highlight, stop Stop, thumbs-down Thumbs-down, thumbs-up Thumbs-up, tip Tip, idea, todo TODO, trash Trash, updated UPDATED.
  4. Click Create New Entry and the New Entry template should appear.
  5. It is a TWiki topic and can be edited in the normal way.
    • Click UWEB, orange, small Edit, Raw Edit or Attach.
    • When editing, start by replacing the line "Tip, idea Please edit and put your text etc. here" with your own content.
    • NB: Do not change the
      %INCLUDE{"%SYSTEMWEB%.LogBookHeader" ACTUALINCLUDINGTOPIC="%TOPIC%" }%
      <!-- 
      Please DO NOT alter or remove the line below this line.
         * Set EDITMETHOD = %SEARCH{"* Set EDITMETHOD = " topic="%PARENTTOPIC%" type="regex" casesensitive="on" nosummary="on" nosearch="on" noheader="on" nototal="on" format="$pattern(.*   \* Set EDITMETHOD = ([^\n]*).*)"}%
      Please DO NOT alter or remove the line above this line.
      -->
      or
      __Back to:__ {{%PARENTTOPIC%}} 
      sections.
    • Update the Subject line or Status using the form at the bottom, as needed.
    • Click Save to save the edits and return the topic display.
    • Click the Logbook name link to the RHS of the Back to: to return to the Logbook's Top Level page.

Sorting entries

  • Click on the No., Date, Author, Subject or Status fields in the header bar to select sorting of the table by that entity.
  • Click again on the selected field in the header bar to reverse the sort order.

Filtering entries

  • Enter strings into the Author, Subject, Status and Entry Text fields in the Filter footer bar and click Filter to restrict the entries listed to those matching the filter expression. The Entry Text field matches any text present in Logbook entry's topic.
  • The filter fields are logically ANDed.
  • The Author, Subject, Status and Extry Text fields can be simple text strings or for more advanced usage Regular Expressions. Filtering by date+time range is via two pop-up calendars. See below.
  • To return to the full, unfiltered table of entries, click Index Show all Entries above the header bar.
  • To remove the table of entries, click Index Remove Table above the header bar.
  • InfoPop-up Calendar tipsInfo
    • This feature allows the logbook entries displayed to be filered by a range of dates+times. The Start date+time is selected in the upper field and the End date+time in the lower field. Click the img.gif icons to activate the calendars.
    • After activating the calendars to choose the filter date-time search limits, you may need to click on the desired date/times in both calendars to ensure the range is properly selected before clicking the Filter Button.
    • The Calendar's remember their previously chosen settings (if any) for for up to a month via browser cookies and will return to them when clicked.
    • The Start date+time (upper field) selected must be less than or equal to that in the End date+time (lower field). If not a separation of 1 week will be choosen.
    • The two date+time fields can also be edited by hand and the pop-up calendars when next activated should reflect any edits made.

Displaying Entries

  • Click Index View Entries in Full above the header bar to display the entries in full. Full text, graphics etc. are shown. If a filter setting is in force, only the matching entries are shown.
  • Click Index Show All Entries Table above the header bar to remove any filters, remove the View Entries in Full display (if active) and display the unfiltered entries table.
  • Click Index Remove Table to remove the entries table, leaving the View Entries in Full display (if active).

Overview

  • The LogBooksOverview page provides a aggregate view of the logbooks in the web.
  • It has the same features as the individual logbooks with the addition of a LogBook Name column in the table, by which it can be sorted and filtered.

Tags

  • Tags provide an extra way to help find content and navigate the TWiki, particularly where large amounts of information abound.
  • The Logbook provides two entirely separate tagging features for maximum flexibility. These are based on the TagCloudPlugin and TagMePlugin.
    1. The Logbook's TagCloudPlugin feature is very simple. It is encapsulated in a Twisty activated by the Show TagCloudPlugin Tag Cloud for above selected entries link.
      • It simply displays a tag cloud based on words occuring more than twice in the relevant logbook entries, excluding common english words.
      • It requires no user tagging of content or other user intervention.
      • The tag cloud's results honour any filter settings active in the logbook entries table above.
    2. The Logbook's TagMePlugin feature is much more sophisticated.
      • It provides a Tag Cloud and a tag search feature based on the plugin's TagMeSearch facility.
      • The Tag Cloud is encapsulated in a Twisty activated by the Show TagMePlugin LogBook Tag Cloud for all entries link.
      • Its results are links which can be clicked to get to the plugin's TagMeSearch page but you are advised NOT to do this. Instead, use the logbook's own Tag Search feature below.
      • The tag search feature is headed TagMePlugin LogBook Tags (all entries)

Miscellaneous

  • A list of the logbooks present in this web can be found at LogBooks.

Bugs

  • The header and Filter footer bars can flip location under certain list sort selections.
  • The sort by Subject field does not currently work.
  • The Back to: links do not render when dumping entries.

Credits

  • My special thanks to Peter Thoeny for his invaluable advice in implementing this logbook, T.Crane, December 2012.

-- TomCraneAdmin - 26 Sep 2012

Edit | Attach | Print version | History: r3 < r2 < r1 | Backlinks | Raw View | Raw edit | More topic actions...

Physics WebpagesRHUL WebpagesCampus Connect • Royal Holloway, University of London, Egham, Surrey TW20 0EX; Tel/Fax +44 (0)1784 434455/437520

Topic revision: r1 - 29 Dec 2012 - TomCraneAdmin

 
This site is powered by the TWiki collaboration platformCopyright © 1999-2018 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding RHUL Physics Department TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.LogBookHelp.