1. Configuration of ACF-Docu
In this guide, we will walk you through configuring ACF-Docu to suit your specific needs.
Table of contents
1.1. The Preferences Button ↑
When you start the application, you will find the "Preferences" button in the interface.
Clicking on this button takes you to a screen with various tabs:
Folder Preferences: Configure folders for your Markdown project and set the
html_root_path. You can also enter your ACF plugin license code.Header: Add extra content to the
<head>...</head>section of the HTML files generated by ACF-Docu.Footer: Define a footer for your HTML pages.
Top-Navigation: Customize the top navigation, including the ##NAV## placeholder, and add additional buttons and links.
Left-Navigation: Specify HTML content to appear above and below the left navigation menu.
MD-Template: Set up a Markdown template for new documents, containing standard sections.
Other Preferences: Configure miscellaneous preferences.
ACF: Adjust the ACF plugin's code.
Books: Define books, including their titles and starting HTML pages.
Categories: Configure document categories, shared between books, and displayed in the left navigation.
1.2. Folder Preferences ↑
In the "Folder Prefs" tab, you can select folders for your Markdown documents and the "site" folder for HTML documents. The ACF-Plugin license is usually preconfigured.
1.3. Header Preferences ↑
The "Header Prefs" section allows you to add text to the HTML header, typically for linking JavaScript or CSS files.
1.4. Footer Preferences ↑
Use the "Footer Preferences" tab to define content that appears at the bottom of your documents.
1.5. Top Navigation Preferences ↑
The "Top Navigation" preferences include a placeholder for generated navigation elements. You can add custom content such as buttons and links.
1.6. Left Navigation Preferences ↑
In the "Left Navigation" preferences, you can specify HTML content for the top and bottom of the left navigation menu.
1.7. Markdown Template ↑
The "MD-Template" tab allows you to create a template for new documents. This template is inserted when you create a new file.
1.8. Other Preferences ↑
When we drag images from any place, to example the desktop - we get a path into the MarkDown document. This must be altered to have  like below. The Markdown editor Light-Paper does this automatically, but it´s not free.
The File is copied into the images folder for the html_root_path. To make the Markdown still be able to show the document in its new location, it is altered to:
This new path needs to be stripped for this ../../ html_root_path/ in order for the HTML file to work as expected inside this html_root_path, so we only have images/Folder-Structure.png as the image source for the image tags in the html. Dependent of your naming of the html_root_path, and the placement of your MarkDown Doc directory, we need to adjust accordingly. The best way is to run the Preview on the document, and then see how the image path is updated. Then that comes before images in the path that should be removed.
1.9. ACF Function Preferences ↑
The "ACF" tab lets you customize the ACF functions, which play a crucial role in document production. Those functions are called when you ask to preview a document (producing the HTML file). It is possible to tweak those functions to alter the result of the document production. A source file of those ACF functions comes with the application and can be loaded back if some edits do not go the way you want. You can always ask for advice here if you need to accomplish something special. Look at the instruction videos and the ACF reference manual to get started on this journey.
1.10. Books Preferences ↑
You should always have at least one book. Use the "Books" preferences to define book titles and start HTML pages. Additional books can be added.
1.11. Categories Preferences ↑
In the "Categories" preferences, you can manage a list of categories available in the drop-down menu in your main document. The list can contain more categories than you actually use and is shared amongst the books. The sort number is to order the categories in the menu.
