Libraries

You need the “Create Style” permission. For details, see Libraries and Permissions.

Creating a Library

Create a library to build a web viewer from several documents, as follows.

Library menu

Library menu

To create a library, follow these steps.

  1. Go to the <Tool | Library> menu.

  2. Click the <Create Library> link.

  3. Enter the “Basics”, such as the name, and select the language.

  4. Click the button.

Style affects only the library search page. Regardless of the library settings, the look of the web viewer is determined by the web viewer layout.

The following style options are supported.

Logo

Select the logo.

Logo Link URL

Set the logo link URL. When you click the logo, you go to the link address you set.

Favicon

Select the favicon.

Theme Color

Select the theme color of the library.

Accent Color

Select the accent color of the library.

Theme

Select the theme to apply to search results.

Layout

If you set a web viewer layout in the library, it takes precedence over the web viewer layout set for individual documents.

CSS

See Customizing Libraries with CSS.

Main Page

See Setting the Library Main Page.

Footer Page

See 바닥글 페이지 설정하기.

Alignment

Arrange the library menus by selecting left, center, or right alignment.

Height

Set the height of the library menu bar. Select one of five levels from "Extra Small" to "Extra Large".

Spacing

Set the spacing between menus in the menu bar. Select one of five levels from "Extra Small" to "Extra Large".

The following options are supported.

Show Sidebar

Determines whether to show the document explorer in the left side panel when the library opens.

Disable the opening of submenu on mouseover.

Select this option to open submenus only when they are clicked.

Creating files with the scheduler

See Creating Files with the Scheduler.

Open Link in New Window

When you click an external link, it opens in another web browser tab(or window).

Hide a Logo.

Select this option to hide the logo.

Keep the library.

See Keeping the Library.

Hide search in top.

Hides the top search box that appears on the right. Regardless of this option, it is not supported in exported HTML.

Search history is not recorded for individual documents.

When you search in a library, the search history is recorded not only for the library but also for individual documents. Select this option to not record search history for individual documents.

Hide documents without search results.

When you search, documents without search results are hidden from the document list.

Disable the access of Web Crawler.

Select this option to prevent external search engines from crawling the library.

Disable access for users who are not logged in.

By default, users who are not logged in can also access the library. Select this option to block access for users who are not logged in.

Hide Menu Descriptions.

Select this option to hide the menu descriptions shown in library submenus.

Organizing Library Documents

Creating Menus

To add a menu, follow these steps.

  1. Select the library you created.

  2. Click the <Create Library Item> link.

  3. Enter the basics, such as the name, and select the “Type”.

The types of “library menus” are as follows.

Menu

The “Menu” type builds a menu by creating columns and adding groups or items to them. When you click a “Menu” type menu in the web viewer, several submenus arranged in columns appear. A column without items or groups does not appear in the web viewer.

Document Menu

The “Document Menu” type creates a menu by selecting a document or a page. When you click a “Document Menu” type menu in the web viewer, the ManualWorks document opens.

Link Menu

For the “Link Menu” type, you enter a URL when you create the menu. When you click a “Link Menu” type menu in the web viewer, the URL you entered opens.

Glossary

Select this type to add a glossary menu to the library. When you click the glossary menu in the web viewer, the glossary window appears.

  1. Click the button.

Adding Columns

Add columns to library menus of the “Menu” type. With one column, the menu appears as follows.

With one column

With one column

With two or more columns, the menu appears as follows.

With two or more columns

With two or more columns

A column without groups or items does not appear in the web viewer.

Setting Column Spacing and the Footer

When a “Menu” type library menu has two or more columns, you can select the 1spacing between columns and set the 2last menu as the footer.

Creating Items

To create an item, follow these steps.

  1. Select a library menu of the “Menu” type.

  2. Click the <more_horiz> icon of the column.

  3. In the context menu, select <Add Item>.

    • To add several documents, select the <Add Document Items> menu.

  4. Enter the “Basics”, such as the name, and select the type of item to add(Document/Link).

    • If the type is “Document”, select a document or a page. If the type is “Link”, enter a URL.

  5. Click the button.

Adding HTML Items

You can add HTML items to library menus of the “Menu” type. Click the <more_horiz> icon of the column to select it.

Creating Groups

Use groups to bundle related items. To create a group, follow these steps.

  1. Click the <more_horiz> icon of the column.

  2. In the context menu, select <Add Group>.

  3. Enter the “Basics”, such as the name.

  4. Click the button.

A group without items does not appear in the web viewer.

Changing the Order and Position

Drag and drop the drag_indicator icon to change the order or position of menus, columns, and other items, as follows.

You cannot put a group inside another group.

“Fill Available Width” for Library Menus

Set the "Fill available width" option in the <Update> menu of each library menu.

Menus without the option are distributed in the space left after the menus with “Fill available width” take their width. For example, the figure below shows the <Home> menu and the <Q&A> menu with the “Fill available width” option set and “Center” alignment applied.

“Fill available width” takes precedence over “Alignment” in the library style.

If you set “Fill available width” on the first menu, the remaining menus are aligned to the right even if you set “Left” or “Center” alignment. To use both options together, set the “Fill available width” option on several menus to match the style you want, as in the example above.

Copying a Library

You can 1copy a library. When you copy a library, all of its library items are also copied.

Publishing a Library

To publish a library, click the <Update Publishing> link and set whether to publish it and its link address.

Library Search

When you search in a library, document titles are also searched.

Searching Among All Words Entered

If you select “2Search among words entered” in the 1search options of the web viewer and library, ManualWorks finds not only the whole search keyword but also the individual words separated by spaces.

Viewing the Full Table of Contents of a Document

In the library's document explorer, click the <1apps> icon to show the full table of contents of the document.

When you click a title, the web viewer opens in a new window.

Setting the Documents to Search

Use the <Set Documents for Search> menu to set the documents that can be searched in each library.

To set the documents to search in a library, follow these steps.

  1. Go to the <Tool | Library> menu.

  2. Select the library to set the documents to search for.

  3. Click the <Set Documents for Search> link.

  4. Click the <Choose a document.> link to select the documents to search.

  5. The library page searches and shows results from the documents you set.

    • If you select the “Published Documents” option, only documents published to everyone are searched.

    • When you set the documents to search, the document explorer shows only those documents.

If you do not set them, or when you export to HTML, the documents used in the library menus and items are searched, as in earlier versions.

Not Recording Search History for Individual Documents

If you select the “Search history is not recorded for individual documents.” option when you create or update a library, searches in the library are not recorded in the search history of individual documents.

Exporting a Library to HTML

Books, short documents, static documents, and similar documents are created as HTML. Topic documents, blogs, and video documents are handled as links to the installed ManualWorks server.

Exporting

To export a library to HTML, follow these steps.

  1. Go to the <Tool | Library> menu.

  2. Select a library in the library list, and then click the <1Export> link.

  1. Click the button.

If you set a link for the library, you can download the exported HTML file by adding the .zip extension.

When you export a library to HTML, the base URL set in <Preferences | General> is added to the front of 2“library menu” URLs that start with /.

Creating Files with the Scheduler

If you select “Creating files with the scheduler” in the <Create Library> or <Update Library> options, the library is created as an HTML file once a day at a set time. Set the time for DocumentFileBuilderScheduler in the <Servers | Scheduler> menu.

Setting the Library Main Page

You need the “Create Style” permission.

You can also set the main page right when you <Create Library>. To set a web page (in Korean) as the library main page, follow these steps.

  1. Go to the <Tool | Library> menu.

  2. Select the library to set the main page for.

  3. Click the <Update Library> link.

  4. In “Style”, select the main page.

    • If you do not set a main page, the tables of contents of the documents are listed.

  5. Click the button.

To create a page, see the following guide.

To build a page, see the following guides.

If you do not set a main page, a main page based on the library menus is provided. Because you cannot set the order of documents and other details, we recommend building the main page yourself with a web page. This lets you build a fixed layout, like the 3Rabbitz help page (in Korean).

Customizing Libraries with CSS

To customize a library with CSS, see 라이브러리 CSS로 꾸미기.

Keyword Menus

When you create a library menu, you can enter a "keyword" to build the menu.

Providing the Library's Default Link with the #home Keyword

If you set the “Name” to #home when you create a library menu, the menu provides the library's default link.

Showing the File Download Page with the #download Keyword

If you set the “Name” to #download when you create a library menu, the menu provides a page where you can download the PDF, EPUB, HTML, and other files of all documents in the library in one place (in Korean).

This menu does not appear in exported HTML.

Keeping the Library

When several libraries contain the same document, an arbitrary library appears when the document is shown. If you select “Keep the library.” in the library options, the library you are currently viewing stays shown.

If you set a default library for documents and web pages, the “Keep the library.” option is ignored and the library you set always appears.

Libraries and Permissions

Only users who have the "Create Style" permission can set up libraries. However, if you select "Allow users with the write role to edit the library." in the <Preferences | General> menu, users who have the "Write & Read" permission can edit library items.