WebShelf Help

WebShelf lets you collect information into your own personal Library. Libraries can have one or more Shelves, which are shown in the Bookcase. When you select a shelf by touching it the shelf's current Books are displayed in the Bookshelf. As you select books the last viewed Page of each Book is displayed in the Page Display area.

The first time you run WebShelf it creates a new library for you entitled MyLibrary. Note: The Shelf Tools section below describes how you can change the name of this new library to a name you prefer. The initial library consists of one shelf and one book. You can use the tools described below to add shelves and books as you desire. The following sections walk you through how each of these tools work.

Main Screen

The WebShelf main screen consists of several areas: on the left side is the Bookcase, which holds Shelves in your current Library. At the top is a Bookshelf which displays all of the books for the selected bookcase shelf. The title of the current library is displayed at the top of the bookcase. To the right of the bookcase is the Page Display area which shows the current page from the currently open book. Each of these items are described in the sections that follow.

Bookcase

The Bookcase displays one or more shelves from your library. When you initially start WebShelf it creates a new library containing one shelf, with a default title. Please refer to the Bookcase Tools section below to learn more about how you can rename this new shelf.

Arranging Shelves

The bookcase displays shelves in the order they were added. But, you can rearrange this order any way you'd like by long-pressing on a shelf until the tracker symbol appears then dragging the selected shelf up or down the bookcase until you reach the desired location.

Bookcase Tools

The Bookcase Tools allow you to Add, Remove or Edit bookcase shelves. The Search tool allows you to search for matching page description in all of the pages in your library. The Library Management tool allows you to Add, Remove, Edit, Lock/Unlock and Open libraries. The Settings tool allows you to configure various app defaults.

Adding a new shelf

Choose the add shelf (plus) tool to add a new shelf to your bookcase. You can name the shelf anything you'd like. When you're satisfied with the name you've chosen press OK.

Removing a shelf

Choose the remove shelf (minus) tool to remove the current shelf. You're asked to confirm your decision then the shelf is removed from your bookcase, along with all of its associated books and pages. Keep in mind this action cannot be undone and you're removing all of the books and pages you've added to the shelf. Choose this action carefully.

Editing/Renaming a shelf

Choose the edit tool (pencil) to edit the name of the currently selected shelf. Once you're satisfied with the name press OK to update the shelf in the bookcase.

Searching books

Choose the search tool (magnifying glass with text) to find pages across your entire library that match the page descriptions you specify. If any matching pages are found you're presented with this list and you can select the desire page simply by touching an entry. The corresponding book and page are automatically loaded.

Managing libraries

Choose the library tool (books in a box) to manage your libraries. This screen allows you to create a new library, open another library, rename your current library, delete a library, password protect a library or get general information about a library such as its size, number of shelves, books and pages. Refer to the Manage Libraries screen section for further details.

Settings

Choose the settings tool (gear) to change general behavior of WebShelf, such as whether to load your previous library each time it starts. Please refer to the Settings Screen section for additional details.

Open last library on launch

Choose this setting option to automatically load the last library you were working with each time WebShelf starts up. Keep in mind that if your library is locked (password protected), you're required to enter a valid password at startup, otherwise the Library Management screen is displayed to allow you to select a library.

Animate page turns

Choose this setting to enable/disable the page turn animation WebShelf shows as you navigate through pages.

Default to offline pages

Choose this setting to determine the initial value of the Available offline switch on the Add Page screen.

Show tool titles

Choose this setting to show the name of each tool below each tool's button.

Use external storage (Android only)

For Android devices WebShelf will detect if you currently have an SD card available and give you the option to store librarys on the SD card. This option allows you to toggle on and off the use of the SD card. Changing this option won't cause you to lose data, but note that turning off Use external storage causes libraries stored on the SD card to not appear in the Manage Libraries list of libraries.

Online help

Choose this to view this online help information.

Clear browser data

WebShelf uses a built-in browser to add new pages and to allow you to view your online pages. As you navigate web sites the built-in browser collects temporary (cached) information and cookies to allow you to easily navigate, remember your login information and so forth. This option allows you to remove the currently stored cookies and cached information. Note that this is essentially the same option as Safari's Manage Website Data under Preferences. But, WebShelf's option only clears data used by WebShelf's built-in browser.

Privacy policy

Choose this option to view WebShelf's privacy policy.

Version information

This displays the current version of WebShelf, including details about each build version, along with the open source tools used by WebShelf.

Bookshelf

The Bookshelf holds all of the books you create for the currently selected bookcase shelf. You can long-press on a book to drag it to a new location on the bookshelf, allowing the complete rearranging of books. The Bookshelf Tools described below are used to add, remove and edit books on the current bookshelf.

Arranging books

Books are placed on the bookshelf in the order they were added. But, WebShelf allows you to rearrange your bookshelf in any fashion you desire. To move a book to a new location simply long-press on a particular book until you see a tracker symbol appear, then drag the book to the desired location and release it.

Moving a book to a different shelf

You can also move a book to a different shelf by choosing the Move button as described in the following section.

Bookshelf Tools

The Bookshelf Tools allow you to Add new books, Remove the currently selected book or Edit the currently selected book to change its Title and Color.

Adding books

Choose the add book tool to add a new book to the current shelf. You can enter the book's title, as well as it's color. WebShelf picks a random color for each new book, but you can change this by selecting the color square to bring up the color selection screen. Once you're satisfied with the books information press Ok to add the new book.

New books are always added at the end of the current bookshelf. But, you can move them to the desired location by long-pressing and dragging. Please refer to Arranging Books for further details.

Removing books

Choose the remove book tool to remove the currently selected book. Please note this action is permanent and not only removes the current book, but also all of its associated pages. Use this tool carefully.

Editing books

Choose the edit book tool to change the title and color of the currently selected book. The fields on this screen are exactly as described when adding a book, with the exception that the color selection reflects the book's current color.

Moving a book to another shelf

Choose the move book too to move the selected book to a different shelf. The Move Book screen appears and allows you to select the name of the shelf where you wish to move the book. The book will be added to the end of the selected shelf.

Toggle

You can use the Toggle button to contract or expand the bookcase area. When shown the bookcase overlays a portion of the Page Display area. Hide the bookcase to take full advantage of the extra screen space and allow for maximum readability.

Page Tools

The Page Tools allow you to view the Table of Contents for the current book, Search and highlight specific words on the current page, Add a new page, Remove the current page, Edit the current page's title and description, Trim unwanted sections from the current page and Share (or print) the current page. Note that printing requires and AirPlay capable printer.

Choose the table of contents tool (bulleted list) to display the pages in the current book. You can jump directly to a new page by touching an entry. You can also arrange the order of pages, as described below.

Arranging page order

The arrange widget (stack) on the right side of the table of contents screen allows you to use drag and drop to rearrange the pages in your current book. Start by long pressing the arrange widget until the tracker icon appears. At this point you can drag the selected page up or down the list to change its order. Once you're satisfied with the position, release the item you're dragging and your new page order is established.

Moving a page to to a different book

You can also use the arrange widget (as mentioned in Arranging page order) to move a page in the table of contents to a different book. Long-press the arrange widget until the tracker symbol appears, then drag the page to a new desired book location and release. The page will disappear from the current book's table of contents and will instead show up when the display the table of contents for the book you've chosen to move it to.

Adding a page

Choose the add page tool (plus document) to add a new page to the selected book. The new page is added as the last page of the book, but you can use the table of contents tool mentioned above to rearrange the page order to one you prefer. Please refer to the Add Page Screen section for further details regarding this screen.

Adding a pdf page

Choose the add pdf tool (plus left of document) to add a new pdf file to the selected book. The new page is added as the last page of the book, but you can use the table of contents tool mentioned above to rearrange the page order to one you prefer.

Removing a page

Choose the remove page tool (minus) to remove the current page. Note: Keep in mind this action cannot be undone. The current page, along with its associated description will be permanently deleted.

Editing a page

Choose the edit page tool (pencil) to change the title of the current page. The initial values for both of these items were pre-filled with a 'best guess' title and description when the page was initially added. It's a good idea to edit new pages as you add them to ensure they have useful titles and descriptions (which are used for searching). For instance, a new holiday cookie recipe is much easier to find with a description such as 'holiday sugar cookies', but the initial description (from the best-guess) may be little more than the web address of the page. The Address field contains the original URL of the page you added. This field is read-only, but you can select and copy this address allowing you to paste it into the browser or in the Add Page browser to return to this location again.

Searching a page

Choose the search page tool (magnifying glass) to highlight specific words on the current page. When the search is completed you can scroll through the page to see the highlighted instances of the word(s) you searched for.

Trimming a page

Choose the trim page tool (stack) to remove unwanted sections of a page you've made available offline. (Please note this option is only available for offline pages). When you initially add a page there are often portions of blank areas, or sometimes comments you don't wish to save and so forth. The trim page tool allows you to select each section (a pdf page) using the thumbnail view on the left and remove it from the page. Please refer to the Trim Page Screen section for further details.

Converting a page

WebShelf allows you to store pages as online (active links) and offline (PDF files) which is determined at the time you add a page. This tool allows you to swap the current page between online and offline versions. Please not that directly added PDF files using the add pdf tool don't allow this option, since they are permanently added as an offline version.

Sharing a page

Choose the share page (share icon) to share or print the current page. The sharing options are the typical system-wide sharing capabilities you should be familiar with already on your device. Please refer to specific device documentation regarding the use of the sharing screen. Please note that printing requires an AirPrint capable printer for iOS and a wireless printer for Android. Again, please refer to your device's documentation regarding how to configure and use printers with either AirPrint or Android wireless printing.

Page Display

The Page Display shows the current book page in a window you can scroll up and down and pinch zoom in and out. You can also navigate through (non-zoomed) pages by swiping left or right on the page, or you can use the paging buttons on the lower corners of the page. Tip: Use the Table of Contents tool to quickly jump to pages. Also, keep in mind the Toggle tool allows you to expand the page display's reading area at any time.

Navigation buttons

The normal back, forward, refresh/stop buttons are located at the top of the page display area when you're viewing an online-only page. You can use these buttons to help you navigate the live content. Keep in mind the page will always start at the original location you saved when the page was added if you switch to another page.

Moving the current page to a different book

The arrange widget (stack) to the right of the Main Screen's page title allows you to drag and drop the currently displayed page to a different book. Start by long pressing the arrange widget until the tracker icon appears. At this point you can drag the selected page to the book on the shelf where you wish to move it. Once you release the dragged page it will be moved to the new book. Note that you can only move pages to books which are displayed on the current shelf.

Add Page Screen

The Add Page screen allows you to browse the internet and add a new page to your current book. This screen presents you with the following items:

Navigation buttons

The left and right facing arrow buttons allow you to move backward and forward though web pages you have visited. These work the same as your normal web browser.

Refresh button

The refresh button, adjacent to the navigation buttons, reloads the current web page. While the page is loading the circular arrow is replaced with a stop (X) button. This button also works the same as your normal web browser.

Offline

By default WebShelf saves local copies of all pages, so you can view them whether you're currently connected to the internet or not. If you'd prefer to always fetch a fresh copy of a particular page, then turn off this option. This tells WebShelf to always display the online copy of the page, if you're currently connected. If not, you'll receive a message indicating the page is only available when you're online.

Online-only pages are a great option for dynamic content, such as videos, news, stock tickers and so forth. You can still use all of WebShelf's shelves, books and page capabilities as you normally do with with offline pages, but now have the added benefit of handling pages that need fresher content, or in some cases (such as with video content) aren't available when the page is saved for offline viewing.

Address

The input field directly below the navigation buttons contains the URL (address) of the site you wish to visit. You can enter a url here, or you can enter items for which you wish to search. For example, you could enter "New iPads", then press Go (see below). This performs a search and returns a list of matching web pages.

Go

The go button loads the page (or search term) currently entered in the address field. Note that while the page is loading the refresh button temporarily transforms into a stop (X) button. Once the page has completely loaded the refresh button changes back to its normal circular arrow appearance indicating the page loading has completed.

Save/Cancel

Once you're ready to add the browser's page to the current book you can press the Save button. If you change your mind you can press Cancel instead to close the Add Page screen without adding a new page.

Tips on saving offline web pages

Web pages are comprised of many dynamic elements, often those elements are loaded as-needed using such technologies as Javascript. This may present challenges when saving your pages for later reading. For example, the page may show images when you initially view it in the add page screen's browser, but the saved page may be missing some or all of these images.

While WebShelf endeavors to fully capture all of the page's content, in reality this sometimes falls short. There are certain pages that don't lend themselves to being saved for offline viewing. To ensure the most success when saving pages it is best practice to fully scroll through and view your entire page in add page's browser before you press the save button. This gives WebShelf the best chance of capturing as much of the dynamic content as possible.

Trim Page Screen

The Trim Page screen is available for offline pages only. It allows you to trim away some of the excess/unwanted portions of a page you've saved for offline viewing.

The sections for removal consist of a series of equal-sized sections and may or may not align exactly with the content you wish to remove. Use your best judgement to remove as much of the blank/unneeded content around the sections of the page you wish to retain. If you remove more than you wish you can always use Cancel (as described below) to start over.

The screen consists of three sections: the Tool area (top), Thumbnail area (left) and Page display (center). The tool area allows you to Save or Cancel the page trimming. The Scissors are used to cut the currently selected section in the thumbnail view. As you navigate the thumbnail view the page display shows the currently selected page.

Please note Cancel (or X) closes the Trim Page screen and returns you to the main screen, leaving the current page in its original state, regardless of how many sections you've removed. This is a good option when you've removed more content than you desire and wish to start over. Keep in mind once you choose Save your trimming of the page becomes permanent and cannot be undone, though you can continue to trim the page to remove additional sections if you desire.

Tip: If you wish to remove a series of pages, such as blank pages, or comments following the content you wish to keep, the easiest approach is to select the thumbnail which represents the start of the area to remove, then continue to press the cut tool until you reach the content you wish to keep or the end of the page.

For example, suppose you have a recipe followed by ten pages of comments which you don't wish to keep. Let's assume the comments start on page 5 and continue through page 14. The easiest way to remove the ten pages is to select the thumbnail for page 5, press the Scissor tool, then continue to use the scissor tool until all ten pages are removed.

Manage Libraries Screen

The Manage Libraries screen contains various options which all you to control how you use your libraries. Each of these options is described in the section that follows, in the order the buttons appear on the right-hand side of the screen.

Open/Close

The Open button allows you to open the selected library. If you select a currently opened library this option is Close instead, which allows you to close the library (required to Edit or Delete it). Keep in mind that when you're adding a new library you'll want to use Open to make it the active library. Also, for locked libraries you are prompted to enter a password before you can open the selected library.

Edit

The Edit button lets you rename the library you've selected in the list of libraries. Note that you can rename the library anything you wish, but duplicate library names are not allowed.

Lock/Unlock

The Lock/Unlock button allows you to add or remove a password for the currently selected library. If you don't currently have a password (the library isn't locked) you're asked to enter and confirm a new password. (You'll want to make sure you remember this password because there isn't a way to recover lost passwords). Likewise, if the library currently has a password, you can remove it by pressing the lock/unlock button and entering the current password.

Please note many of the operations on the Manage Library screen require you to enter a password if you are attempting to do something with a locked (password protected) library. For example, you may need to enter a password before you can edit the library's name.

Info

The Info button provides information about the currently selected library, such as how many shelves, books, pages it contains, along with the size of the library on the disk.

Add

The Add button allows you to create a new library. Once you've added the library you'll still need to open it using the Open button.

Remove

The Delete button allows you to permanently remove the selected library. This button is not active for the currently loaded library.

Import

The Import button allows you to import WebShelf libraries from other locations such as cloud storage, local storage or network storage. The available locations for import depends on how your device is configured and should show the same options as those available in your device's Files app.

Export

The Import button allows you to export WebShelf libraries to other locations such as cloud storage, local storage or network storage. The available locations for export will depend on how your device is configured and should show the same options as those available in your device's Files app.

Done

The Done button closes the screen and returns you to the main screen. Keep in mind that any actions you've taken on libraries are still retained, the Done button simply closes the Manage Libraries screen.

External keyboard support

WebShelf supports external bluetooth keyboards for both entering text and by providing shortcuts to save you time when adding shelves, books, pages and so forth. The following list of shortcuts are supported. Please note that some are only available when the current book/page support such an action. For example, the PageDown and PageUp shortcuts are only available if there are additional pages to which you can navigate. Press and hold the Command button on your keyboard to see the complete list of supported shortcuts at any given time.

Command-s Add shelf

Command-b Add book

Command-p Add page

Command-l Library management

Command-e Edit page

Command-t Trim page (only available for offline pages)

PageUp Navigates to next page (if available)

PageDown Navigates to previous page (if available)

Command-down Navigates to first page

Command-up Navigates to last page

Command-shift-f Opens Find Descriptions screen

Command-f Search for text on current page

Command-? Launches on screen tutorial (same as ? button on screens)

Command-, Opens Preferences screen

Esc Closes the current screen

Google Sites

Report abuse