Last edited 6 months ago
by Margit Link-Rodrigue

Numbering section headings and Manual:Extension/ImportOfficeFiles: Difference between pages

(Difference between pages)
VisualWikitext
No edit summary
 
No edit summary
 
Line 1: Line 1:
To number section headings, you can add the following declarations to the page ''MediaWiki:Common.css'':
{{DISPLAYTITLE:Word Import}}
{{Textbox|boxtype=important|header=|text=The numbering created in common.css is not applied in the PDF export!
{{BSVersion|bsvFrom=4.2|bsvTo=|bsvFeature=The Word import is}}
==What is the Word import?==
The extension '''ImportOfficeFiles''' allows importing a Word document which will be converted to wiki pages.


<br/>
*The file can be converted to a single page or to a page with subpages.
*Image files are also imported.
*Imported pages can be used as a page collection for creating a book.


Diese Technik funktioniert nur in Wikis, die keine Bücher angelegt haben, da sonst die Nummerierung in den Seitenabschnitten der Buchseiten nicht mehr korrekt angezeigt wird.|icon=yes}}<syntaxhighlight lang="text">
==Import a word document==
#mw-content-text {
'''To import a Word document:'''
    counter-reset: h2counter;
}
#mw-content-text h1 {
    counter-reset: h2counter;
}
#mw-content-text h2 {
    counter-reset: h3counter;
}
#mw-content-text #toc h2#mw-toc-heading {
    counter-reset: h2counter 0
}
#mw-content-text h3 {
    counter-reset: h4counter;
}
#mw-content-text h4 {
    counter-reset: h5counter;
}
#mw-content-text h5 {
    counter-reset: h6counter;
}
#mw-content-text h2:before, article #mw-content-text h2:before {
    content: counter(h2counter) ".\0000a0\0000a0";
    counter-increment: h2counter;
}
#mw-content-text #toc h2#mw-toc-heading:before {
    content:""
}
#mw-content-text h3:before {
    content: counter(h2counter) "." counter(h3counter) ".\0000a0";
    counter-increment: h3counter;
}
#mw-content-text h4:before {
    content: counter(h2counter) "." counter(h3counter) "." counter(h4counter) ".\0000a0\0000a0";
    counter-increment: h4counter;
}
#mw-content-text h5:before {
    content: counter(h2counter) "." counter(h3counter) "." counter(h4counter)"."counter(h5counter) ".\0000a0\0000a0";
    counter-increment: h5counter;
}
#mw-content-text h6:before {
    content: counter(h2counter) "." counter(h3counter) "." counter(h4counter)"."counter(h5counter)"." counter(h6counter) ".\0000a0\0000a0";
    counter-increment: h6counter;
}   
#mw-content-text h2 {
    padding-left:1.3em;
    text-indent:-1.3em
}
#mw-content-text h3 {
    padding-left:1.8em;
    text-indent:-1.8em
}
#mw-content-text h4 {
    padding-left:2.8em;
    text-indent:-2.8em
}
#mw-content-text h5 {
    padding-left:3.4em;
    text-indent:-3.4em
}
.mw-editsection{
    position:absolute;
    padding-left:1.5em
}
#bodyContent .sectionanchors-button{
    margin:-0.8em 0 0 -1.2em;
    max-width:1em;
    font-size:0.5em
}


/*Keine Nummerierung bei */
#'''Click''' ''New > Import Word file'' in the top menu. [[File:Manual:importword-menu.png|alt=Import menu|center|thumb|173x173px|Import menu]]
#mw-content-text .sectionflex h2::before, #mw-content-text .sectionflex h3::before, #mw-content-text .bs-social-entity-wrapper h3::before {
#'''Click''' ''Select a file'' or drag the Word file in the drop zone.[[File:Manual:importword-upoad.png|alt=Upload dialog|center|thumb|Upload dialog]]
    content:none
#'''Click''' ''Next''.
}
#'''Choose''' the import settings you want.[[File:Manual:importword-settings.png|alt=Settings|center|thumb|Settings]]
#mw-content-text .mw-category h2::before, #mw-content-text .mw-category-generated h2::before,#mw-content-text .mw-category h3::before, #mw-content-text .mw-category-generated h3::before, #mw-content-text .bs-tag-pagetemplates h2::before{
##'''Title:'''The title of the wiki page generated by the import. When the content structure is broken up, the chapters are created as sub-pages of this main page.
    content:none
##'''Content structure:'''  If the "Split content to pages" checkbox is activated, subpages are created from the heading levels of the Word document. This is possible up to 3 levels deep.
}
##'''Conflicts with page title''':
  .ns-special #mw-content-text h2::before, .ns-special #mw-content-text h3::before {
##*''Rename:'' The imported page is created as <p''age name>'' (1). However, this should be avoided, especially with large Word files that are divided into additional levels. It is best to enter a new page title here as an alternative.  A naming conflict is displayed in the preview. In this case, if necessary, click Cancel to start the import with a new title. Or select "Override" as a conflict resolution.
    content:none;
##*''Override'': The existing page(s) will be overwritten with a new version.
}
#'''Click''' ''Next''.  <br />The preview shows:  (1) the names of the pages that will be created    (2) via the arrow icon: the files that will be imported for the individual pages  (3) via the eye icon: the content of the individual wiki pages.
#mw-content-text .bs-tag-pagetemplates h2:before, #mw-content-text .bs-tag-pagetemplates h3::before, #mw-content-text .bs-tag-pagetemplates h6::before {
#'''Click''' ''<u>I</u>mport.'' After the import is complete, the created pages are displayed as a page collection in the wiki. You can view the pages from this page by clicking on the link.
    content:none;
{{Messagebox|boxtype=note|icon=|Note text=In a wiki installed with "German" as the content language (contentlanguage), the path to the page starts with ''MediaWiki:Page collection''.|bgcolor=}}
}
 
article #glossar h2::before, article #glossar h3::before {
==Create a book==
    content:none;
It is easy to create a book from the imported pages:
}
 
</syntaxhighlight>
#'''Click''' the plus button.
[[Category:Customizing]]
#'''Enter''' a book title and click Done.
[[en:{{FULLPAGENAME}}]]
#'''Click''' the Bulk Add button.
[[de:Überschriften nummerieren]]
#'''Select''' Page Collection as the source.
#'''Select t'''he page name of the imported file.[[File:ImportOffice-pagecollection.png|alt=Select page collection|center|thumb|450x450px|Select page collection]]The pages have been added.[[File:ImportOffice-bookpages.png|alt=Add book pages and save chapter navigation|center|thumb|650x650px|Add book pages and save chapter navigation]]
#'''Choose''' ''Save and add book navigation to each wiki page'' from the '''Save''' menu.
#'''Click''' ''OK'' in the dialog "Change wikipage" associations. This will add the chapter navigation to each book in the page.[[File:ImportOffice-bookshelf tag.png|alt=add bookshelf tag to book pages|center|thumb|250x250px|add bookshelf tag to book pages]]
The book is now available on the Bookshelf page of your wiki.
 
=== Change the display title of your book chapters ===
Since the display titles of the book pages show the path of the imported subpages, it makes sense to edit the display titles afterwards. To do this, open the book page in source edit mode and remove the path with the trailing "/".
 
[[File:ImportOffice-booksource1.png|alt=Changing the chapter titles|center|thumb|650x650px|Changing the chapter titles]]
If the book has a lot of pages, you can copy the source code into an editor like Notepad++ and replace the following text:<div>
|Employee handbook/
</div>Replace the text and t'''ake care that the vertical pipe''' after the actual page name and before the page title '''is the replacement text'''.<div>
|
</div>Copy the source code back to the wiki and save the book page.
 
[[File:ImportOffice-updatedbooktitles.png|alt=Updated book titles|center|thumb|650x650px|Updated book titles]]
 
== Sources of error ==
 
=== Images are not imported ===
 
* Images have a background/shadow and only the background/shadow is imported: These images are not supported. Solution: Remove the background/shadow before the import.
* Images are embedded as .tmp files in the Word document for an unknown reason. Solution: Before importing, save the images from the Word document locally and then use them to replace the original image in the Word document.
{{Box Links-en|Topic1=[[Reference:ImportOfficeFiles]]|Topic2=[[Manual:Extension/BlueSpiceBookshelf|Books]]}}{{translation}}

Latest revision as of 16:38, 20 October 2023

The Word import is is available from BlueSpice 4.2.

What is the Word import?

The extension ImportOfficeFiles allows importing a Word document which will be converted to wiki pages.

  • The file can be converted to a single page or to a page with subpages.
  • Image files are also imported.
  • Imported pages can be used as a page collection for creating a book.

Import a word document

To import a Word document:

  1. Click New > Import Word file in the top menu.
    Import menu
    Import menu
  2. Click Select a file or drag the Word file in the drop zone.
    Upload dialog
    Upload dialog
  3. Click Next.
  4. Choose the import settings you want.
    Settings
    Settings
    1. Title:The title of the wiki page generated by the import. When the content structure is broken up, the chapters are created as sub-pages of this main page.
    2. Content structure: If the "Split content to pages" checkbox is activated, subpages are created from the heading levels of the Word document. This is possible up to 3 levels deep.
    3. Conflicts with page title:
      • Rename: The imported page is created as <page name> (1). However, this should be avoided, especially with large Word files that are divided into additional levels. It is best to enter a new page title here as an alternative. A naming conflict is displayed in the preview. In this case, if necessary, click Cancel to start the import with a new title. Or select "Override" as a conflict resolution.
      • Override: The existing page(s) will be overwritten with a new version.
  5. Click Next.
    The preview shows: (1) the names of the pages that will be created (2) via the arrow icon: the files that will be imported for the individual pages (3) via the eye icon: the content of the individual wiki pages.
  6. Click Import. After the import is complete, the created pages are displayed as a page collection in the wiki. You can view the pages from this page by clicking on the link.
Note:In a wiki installed with "German" as the content language (contentlanguage), the path to the page starts with MediaWiki:Page collection.


Create a book

It is easy to create a book from the imported pages:

  1. Click the plus button.
  2. Enter a book title and click Done.
  3. Click the Bulk Add button.
  4. Select Page Collection as the source.
  5. Select the page name of the imported file.
    Select page collection
    Select page collection
    The pages have been added.
    Add book pages and save chapter navigation
    Add book pages and save chapter navigation
  6. Choose Save and add book navigation to each wiki page from the Save menu.
  7. Click OK in the dialog "Change wikipage" associations. This will add the chapter navigation to each book in the page.
    add bookshelf tag to book pages
    add bookshelf tag to book pages

The book is now available on the Bookshelf page of your wiki.

Change the display title of your book chapters

Since the display titles of the book pages show the path of the imported subpages, it makes sense to edit the display titles afterwards. To do this, open the book page in source edit mode and remove the path with the trailing "/".

Changing the chapter titles
Changing the chapter titles

If the book has a lot of pages, you can copy the source code into an editor like Notepad++ and replace the following text:

|Employee handbook/

Replace the text and take care that the vertical pipe after the actual page name and before the page title is the replacement text.

|

Copy the source code back to the wiki and save the book page.

Updated book titles
Updated book titles

Sources of error

Images are not imported

  • Images have a background/shadow and only the background/shadow is imported: These images are not supported. Solution: Remove the background/shadow before the import.
  • Images are embedded as .tmp files in the Word document for an unknown reason. Solution: Before importing, save the images from the Word document locally and then use them to replace the original image in the Word document.

Related info



To submit feedback about this documentation, visit our community forum.

Retrieved from "https://en.wiki.bluespice.com/w/index.php?title=Numbering_section_headings&oldid=7444"
No categories assignedEdit

Discussions