Comments (3)
Hi @************, thanks for the suggestion. However, if I understand correctly, you are suggesting that an h6 (for example) should be rendered different sizes depending on where it exists on the page. That's not a good idea: why specify an h6 (or any level) in the source if that header might be arbitrarily assigned some other size?
I suppose the source document should be restructured to be more flat and less deep. As a physical book would normally only have page breaks for the top one or two levels in the hierarchy (such as part and chapter or chapter and section), using a multipage-level
value over 2 doesn't seem like a good idea either (I added this to the README).
If I'm missing something, feel free to provide (or link to) a working example and re-open this issue.
from asciidoctor-multipage.
However, if I understand correctly, you are suggesting that an h6 (for example) should be rendered different sizes depending on where it exists on the page
Hi, I'm not sure you understood what I meant, but you might have, but just in case I'll try to be more explicit.
Input document:
= h1
== h2
=== h3
==== h4
===== h5
====== h6
Desired output document without multipage:
<h1>h1</h1>
<h2>h2</h2>
<h3>h3</h3>
<h4>h4</h4>
<h5>h5</h5>
<h6>h6</h6>
Desired multi page output:
h1.html
<h1>h1</h1>
h2.html
<h1>h1</h1>
<h2>h2</h2>
h3.html
<h1>h1</h1>
<h2>h3</h2>
h4.html
<h1>h1</h1>
<h2>h4</h2>
h5.html
<h1>h1</h1>
<h2>h5</h2>
h6.html
<h1>h1</h1>
<h2>h6</h2>
Live example: consider this page: https://************.com/linux-kernel-module-cheat/linux-kernel-defconfig
It is from a h6 header about "Linux kernel defconfig", which should be the main topic of the page.
However, "Linux kernel defconfig" appears so tiny on that page, especially so under a huge "Linux Kernel Module Cheat" (the toplevel h1) that it is hard for users to understand what is the main topic of the page.
from asciidoctor-multipage.
I'm not sure you understood what I meant, but you might have, but just in case I'll try to be more explicit.
Thanks for providing the live example. It looks like I did understand, but thanks for providing more details to be sure.
As I implied earlier, this extension is intended for use with a source document that is structured like a book, with a hierarchy of levels. The extension splits the document into separate chunks similar to the way page breaks (and perhaps blank pages) are added to a book to separate top levels (such as parts and chapters, or h1/h2). Lower levels (such as sections and subsections, or h3+) are all included in a single chunk with styled headers to establish a visual hierarchy.
This extension is not designed for generating a hierarchical website, where stand-alone pages have various positions in a tree. If you wanted to use Asciidoctor for that, a better way would be to write and generate a separate adoc
document for each page on the website (and not use this extension).
The live example you linked to, at the time I write this, contains only a single h6 subsubsubsection (multipage-level
is probably set to 5) with no child sections. It is totally fine for you to use Asciidoctor and asciidoctor-multipage in this way if it is working for you, but making changes to accommodate this type of use means we would be working against the way Asciidoctor is designed (and thus it is not practical).
from asciidoctor-multipage.
Related Issues (20)
- Error in multiparts documents when partnums attribute is specified HOT 1
- Use --out-file break the links to home HOT 1
- Custom `toclevels` / option to keep full TOC HOT 4
- Clarify usage of Cross-References HOT 2
- ToC generated inside block level (a) table cells with toc2 attr set on command line HOT 5
- Wrong numeration of appendix chapters HOT 4
- source highlight style does not extract to a file HOT 6
- Do not generate the configurate theme style file for Rouge highlighter HOT 2
- The tags which are in the section title are escaped HOT 1
- The appendix section number is wrong. HOT 4
- Variables not substituted in TOC HOT 3
- How do I prevent asciidoctor-multipage from resetting the latex equation counter after every HTML Page? HOT 3
- Error: "Failed to execute goal de.saumya.mojo:gem-maven-plugin" HOT 4
- Inheriting included attributes HOT 9
- wrong permissions on /var/lib/gems/3.0.0/gems/asciidoctor-multipage-0.0.16/bin/asciidoctor-multipage ? HOT 1
- Using output file name for first page (--out-file FILE is not supported) HOT 1
- Cannot disable stylesheets across all pages HOT 1
- Page title based on heading title HOT 4
- Rewrite some parts of extension, adding a Page class HOT 1
- Automatically scroll table of contents so entry for current page is in view HOT 3
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from asciidoctor-multipage.