Better compatibility with include plugin

[vaniwiki]

Edit: I'm talking about the "include section" functionality, not including the full page. But that also has some issues...

For quite some time, this functionality was not working, to my frustration. But recently I found out that include plugin has an issue with the way ComboStrap handles, or takes over, headings. I thought it would be simple to just disable the heading setting in ComboStrap, as I don't use any extra syntax, and let DokuWiki display what it usually would. But that wasn't exactly without issues.

So now I'm torn between restoring the include plugin functionality, which is a crucial part of my setup, or keep using ComboStrap. And of course I can't just drop ComboStrap, as I'm already heavily invested in many of the other features that it offers. Although if there was a theme offering the same database functionality, but leaves DokuWiki's handling of headings (and links) alone, I would jump ship. That is all I need really, less combo, more strap...

At least it the developer can explain the rationale for breaking compability with this feature, and if there is a way to work around it. Personally I don't need ComboStrap to display my document headings, as I already have headings in all my documents. But I still want autotoc and other features to work properly.

Include is a crucial part to many wikis, similar to namespace templates. For the longest time this functionality was absent, but now that I know why, I am very much eager to have it working again. Maybe includes could be brought in after page render, so it doesn't mess with the active page's meta data. This is also another issue, as including pages also include their json headers by default.

Please consider my plea for help. Thanks!

[gerardnico]

Combo makes a difference between a document and a fragment.

• A document is a whole page (with outline ie heading 1)
• A fragment is a part of a page that you include. Slots are fragment for instance.

I don’t know how include works but combostrap captures and deletes the heading 1 when a template as a main header otherwise you would see it twice.

A fragment with a heading 1 is a non-sense because you can have only one by page otherwise you messed up with the assistance technology.

To solve this equation with combostrap:

• you can use a template without main header (ie an index template for instance)
• you can include fragment with heading 2
• you can ask the include plugin to inject the ast because combostrap delete only the first one (spoiler, they will not do it)
• if the fragment is used for templating, you can create your own template with it.

That’s all.

[vaniwiki]

A fragment with a heading 1 is a non-sense because you can have only one by page otherwise you messed up with the assistance technology.

I am trying to include fragments of other pages starting with a heading 2, like #text, #translation and #purport. One can also include pages with sections relative to the main document, but that's beyond the point, which is that I only want a portion of the page to be included in other pages, but it doesn't work. The full page is included, which is not at all what we want...

[gerardnico]

I have a test that pass.

If you can create a little test that does not pass, I can test it.

just 2 pages: one with the include and the included page.

[gerardnico]

The test that I have is
{{section>target page#test1&nodate}}

[vaniwiki]

I will get to that, but so far I have only ever used {{page>path:to:page#section &options}} and that always worked. I won't mind using {{section>page#section}} instead. That is a formality. I just need the content to appear in my page. It is such crucial functinoality, something I would love to see on interwiki level, including pages or sections from other animals.

[vaniwiki]

Does this count as a test...?

• https://prabhupada.io/playground/test
• https://prabhupada.io/playground/test/page

[gerardnico]

It works with the include version of 2022-01-23. I try the last one.

[gerardnico]

I'm sorry but it works for me also on the include version 2023-09-22

My test has the default combostrap with the heading disabled and the include version 2023-09-22 and it's just green.

[gerardnico]

Which template do you use for the pages?

[gerardnico]

I have tested with a holy for the reference and index for the referent (ie with the include statement) and it works for me.

[gerardnico]

This is the generated HTML

And it's messed up. They add some buttons but the selection is there.

<section class="outline-section-cs outline-level-0-cs section-cs">
    <section class="outline-section-cs outline-level-1-cs section-cs">
        <h1 id="test">Test</h1>

        </div>
        <div class="edit-button-cs editbutton_plugin_include_start">
            <form id="" method="post" action="/doku.php?id=include_test">
                <input name="target" type="hidden" value="plugin_include_start"/><input name="secid" type="hidden"
                                                                                        value="1"/><input name="range"
                                                                                                          type="hidden"
                                                                                                          value="0-"/><input
                    name="summary" type="hidden" value="include_reference"/><input name="rev" type="hidden"
                                                                                   value="1712501437"/>
                <input name="do" type="hidden" value="edit"/>
                <button type="submit" title="include_reference">
                </button>
            </form>
        </div>
        <div class="plugin_include_content plugin_include__include_reference">
            <div class="level1">

                <h2 id="section_to_include">Section to Include</h2>

                <p>
                    The section test1 was included from the include-plugin-test page.
                </p>
    </section>
    <section class="outline-section-cs outline-level-2-cs section-cs">
        <div class="edit-button-cs editbutton_plugin_include_editbtn">
            <form id="" method="post" action="/doku.php?id=include_test">
                <input name="target" type="hidden" value="plugin_include_editbtn"/><input name="secid" type="hidden"
                                                                                          value="3"/><input name="range"
                                                                                                            type="hidden"
                                                                                                            value="0-"/><input
                    name="summary" type="hidden" value="Section to Include"/><input name="rev" type="hidden"
                                                                                    value="1712501437"/>
                <input name="do" type="hidden" value="edit"/>
                <button type="submit" title="Section to Include">
                </button>
            </form>
        </div>
        <div class="inclmeta level2">
            &nbsp;
        </div>

        </div>
        <div class="edit-button-cs editbutton_plugin_include_end">
            <form id="" method="post" action="/doku.php?id=include_test">
                <input name="target" type="hidden" value="plugin_include_end"/><input name="secid" type="hidden"
                                                                                      value="2"/><input name="range"
                                                                                                        type="hidden"
                                                                                                        value="0-"/><input
                    name="summary" type="hidden" value="include_reference"/><input name="rev" type="hidden"
                                                                                   value="1712501437"/>
                <input name="do" type="hidden" value="edit"/>
                <button type="submit" title="include_reference">
                </button>
            </form>
        </div>
        </div>
        <div class="level1">
    </section>
</section>

[gerardnico]

To go further, I would need a reproducer (ie a standard Combostrap installation with the last include plugin and nothing more)