I'm investigating whether it is possible to create a template which allows changing the number of columns dynamically within a single page. For example, from two-columns, to one-column, and back to two-columns. This is especially important for data sheets which are used in a wide variety of industries.
I've been rolling out AsciiDoc and Antora in my organization, but I've been getting push back because stakeholders want to maintain our existing data sheet presentation which requires changing the number of columns on a single page. These data sheets are laid out by hand using commercial tools. Typically, data sheets which might start with two-columns at the top of the cover page, then change to having a figure taking up the full width of the page, and then have a full page of text or a table underneath the figure at the bottom of the page. It's not unusual to have data sheets change column layout 3-5 times on a page. Yes, I agree it's not ideal and sometimes makes reading them difficult, but this is the traditional way things have been done for decades. Page 1 and 2 of this example data sheet illustrates the layout problem: [https://www.ti.com/lit/ds/symlink/sn74hc595.pdf](Texas Instruments SNx4HC595 8-Bit Shift Register With 3-State Output Register)
asciidoctor-web-pdf's resume example gave me some hope that this might be possible. I'd really like to be able to use AsciiDoc's include:: function with .csv files to accelerate the creation of data sheets since technical writers spend a lot of time mindlessly converting data from engineers/scientists. This process introduces a lot of errors. In addition, commercial tools make things difficult by embedding styling and text into a single document. Decoupling this would allow updating templates and branding much easier.
Before I attempt to create my own template (and css), I wanted to ask some questions on the feasibility of this idea.
It is possible to change column layout mid-page with asciidoctor-web-pdf?
If it is not possible to control the column layout dynamically, perhaps I could define a few dozen mixed-column page layouts? This would allow designers/technical writers a few choices when designing pages for data sheets.
If either option is possible, I might be able to create an example data sheet for inclusion in this project; but this might take some time.
Hello,
I'm investigating whether it is possible to create a template which allows changing the number of columns dynamically within a single page. For example, from two-columns, to one-column, and back to two-columns. This is especially important for data sheets which are used in a wide variety of industries.
I've been rolling out AsciiDoc and Antora in my organization, but I've been getting push back because stakeholders want to maintain our existing data sheet presentation which requires changing the number of columns on a single page. These data sheets are laid out by hand using commercial tools. Typically, data sheets which might start with two-columns at the top of the cover page, then change to having a figure taking up the full width of the page, and then have a full page of text or a table underneath the figure at the bottom of the page. It's not unusual to have data sheets change column layout 3-5 times on a page. Yes, I agree it's not ideal and sometimes makes reading them difficult, but this is the traditional way things have been done for decades. Page 1 and 2 of this example data sheet illustrates the layout problem: [https://www.ti.com/lit/ds/symlink/sn74hc595.pdf](Texas Instruments SNx4HC595 8-Bit Shift Register With 3-State Output Register)
asciidoctor-web-pdf's resume example gave me some hope that this might be possible. I'd really like to be able to use AsciiDoc's include:: function with .csv files to accelerate the creation of data sheets since technical writers spend a lot of time mindlessly converting data from engineers/scientists. This process introduces a lot of errors. In addition, commercial tools make things difficult by embedding styling and text into a single document. Decoupling this would allow updating templates and branding much easier.
Before I attempt to create my own template (and css), I wanted to ask some questions on the feasibility of this idea.
If either option is possible, I might be able to create an example data sheet for inclusion in this project; but this might take some time.