modules/html2book/README.txt

Html2Book adds an option below book page body fields to automatically create 
a new book page for each html heading and subheading in the body text. This 
makes it possible to create a book in a word processing program, then use 
the resulting html to create a multipage Drupal book in a single step.

Each new book page will have the same author, categories, settings, and other 
characteristics of the original page. If Organic Groups is used and the original
page has been assigned to one or more groups, all child book pages will belong to
the same groups.

All text before the first heading will be retained as the body of the original 
page. Subsequent pages will be added as children of that page, using the 
heading as their title and all text from that point to the next heading as 
their body. Child pages will be nested based on the subheadding number, if 
the subheadings are logically organized.

For best results, combine with Html Corrector and HTML Tidy modules. 

EXAMPLE:

Node 1 Title: My Book

Node 1 Body:
<div>Here is my page.</div>
<h1>Page 1</h1>
  <p>Here is my text for page 1.</p>
  <h2>Page 1a</h2>
    <p>This is page 1a.</p>
  <h2>Page 1b</h2>
    <p>This is page 1b.</p>
<h1>Page 2</h1>
  <p>This is page 2.</p>

Will create the following book pages:

Node 1 Title: My Book
Node 1 Body: <div>Here is my page.</div>
Node 1 Parent: <top level>
Node 1 Weight: -15

    Node 2 Title: Page 1
    Node 2 Body: <p>Here is my text for page 1.</p>
    Node 2 Parent: Node 1
    Node 2 Weight: -15

       Node 3 Title: Page 1a
       Node 3 Body: <p>This is page 1a.</p>
       Node 3 Parent: Node 2
       Node 3 Weight: -15

       Node 4 Title: Page 1b
       Node 4 Body: <p>This is page 1b.</p>
       Node 4 Parent: Node 2
       Node 4 Weight: -14

    Node 5 Title: Page 2
    Node 5 Body: <p>This is page 2.</p>
    Node 5 Parent: Node 1
    Node 5 Weight: -14

For best results with html book text pasted from Microsoft Word documents, 
save the document as 'HTML, filtered' and use the Html Tidy module. When 
setting up HTML Tidy, choose the option to clean up Microsoft Word text. 
1	Html2Book adds an option below book page body fields to automatically create
2	a new book page for each html heading and subheading in the body text. This
3	makes it possible to create a book in a word processing program, then use
4	the resulting html to create a multipage Drupal book in a single step.
5
6	Each new book page will have the same author, categories, settings, and other
7	characteristics of the original page. If Organic Groups is used and the original
8	page has been assigned to one or more groups, all child book pages will belong to
9	the same groups.
10
11	All text before the first heading will be retained as the body of the original
12	page. Subsequent pages will be added as children of that page, using the
13	heading as their title and all text from that point to the next heading as
14	their body. Child pages will be nested based on the subheadding number, if
15	the subheadings are logically organized.
16
17	For best results, combine with Html Corrector and HTML Tidy modules.
18
19	EXAMPLE:
20
21	Node 1 Title: My Book
22
23	Node 1 Body:
24	<div>Here is my page.</div>
25	<h1>Page 1</h1>
26	<p>Here is my text for page 1.</p>
27	<h2>Page 1a</h2>
28	<p>This is page 1a.</p>
29	<h2>Page 1b</h2>
30	<p>This is page 1b.</p>
31	<h1>Page 2</h1>
32	<p>This is page 2.</p>
33
34	Will create the following book pages:
35
36	Node 1 Title: My Book
37	Node 1 Body: <div>Here is my page.</div>
38	Node 1 Parent: <top level>
39	Node 1 Weight: -15
40
41	Node 2 Title: Page 1
42	Node 2 Body: <p>Here is my text for page 1.</p>
43	Node 2 Parent: Node 1
44	Node 2 Weight: -15
45
46	Node 3 Title: Page 1a
47	Node 3 Body: <p>This is page 1a.</p>
48	Node 3 Parent: Node 2
49	Node 3 Weight: -15
50
51	Node 4 Title: Page 1b
52	Node 4 Body: <p>This is page 1b.</p>
53	Node 4 Parent: Node 2
54	Node 4 Weight: -14
55
56	Node 5 Title: Page 2
57	Node 5 Body: <p>This is page 2.</p>
58	Node 5 Parent: Node 1
59	Node 5 Weight: -14
60
61	For best results with html book text pasted from Microsoft Word documents,
62	save the document as 'HTML, filtered' and use the Html Tidy module. When
63	setting up HTML Tidy, choose the option to clean up Microsoft Word text.