Empty first page after upgrading to version 3

ralmqvist

I just updated to version 3 of adoc Studio and now my documents have an empty first page. I also see this on the included manual.
Is there a way to get rid of the empty page?

fblome

Hmm, very strange. When I select the Composite Document "Manual" I get the PDF as expected.

fblome

But I do see a quirk in the Style Manual. If you start your document with at == there is indeed an empty page.
If you select a different style (in Products or the Preview) the empty page disappears.

For using the Manual style, I'll post a fix tomorrow (it's 23:00h in Germany).

ralmqvist

My problem, at least I think it worked differently in the previous version, is that I would like to have the title and toc on the firs page, below the line. Now when I open documents the use of one (1) = moves it to the second page. Is this a bug or am I doing something wrong?

fblome

I have to inspect it. Can you send me the AsciiDoc test until == Background ? Or just the whole .adoc file?

fblome

Maybe a quick guess before you sending any text:

Remove the line --- before the title line = INTSMRT-nnnn. Does that help?

ralmqvist

One thing I note is that I get this warning.

What I find is that anything I put above = INTSMRT-nnnn, e.g., --- leads to things moved to a second page. If I put
--- and/or the logo below = INTSMRT-nnnn then it stays on the same page but then it doesnt look like our other documents.

What I want to achieve is to replicate templates we have in another program where we our company logo, a divider, title, subtitle and version. TOC should be on its own page.

I have just started using adoc Studio and I am pretty sure my document looked like that before i updated to version 3, but I am not 100% sure. Regardless, I am open to any suggestion on a way to fulfill the requirement.

ralmqvist

[unknown]: Not sure if you wanted here but I Ill first post it here.

`
// Variables
:icons: font
:toc: macro
:toclevels: 2

:source-highlighter:

//:interface-name:

:png-size: 18

//:doctype:

////
Table

| 1 | 2 | 3 | 4
|===
////

////
image:CleanShot 2025-04-24 at 13.28.33.png[]

kbd:[key]
btn:[button]

NOTE: Additional notes are displayed as a note.

TIP: Whenever there is an opportunity for a special hint, you will receive a tip.

WARNING: The bell appears to alert you to special features.

CAUTION: Whenever you need to take special care before performing an action, this warning will appear.

IMPORTANT: Attention, here we try to draw your attention to existing dangers, damage or consequences.

////

// Document information
:revnumber: 1.0

image:CleanShot 2025-04-24 at 13.28.33.png[width=200]

= INTSMRT-nnnn
[.subtitle]
WH-I-09: Get address information for Process Type 2010

Document version: {revnumber} - {last-update-label} {docdate}

toc::[]

<<<<

== Background`

fblome

Ok, thanks for the source. I can see now what happens:

The image image:CleanShot 2025-04-24 at 13.28.33.png[width=200] before the = title does not work. I'll show you an alternative below.
The huge comment blocks are causing the = title an error. I had double checked with the developer, and he told me it is a bug on our side. We will fix this. In the meantime you can remove the huge comment blocks before the title and put it below (if you need them), or just move them onto another page.

Ok, now the title page. AsciiDoc has brilliant feature for that you should use. Here is a minimal example:

:title-page: 
:title-logo-image: image:https://adoc-studio.app/images/logos/adoc-logo.png[pdfwidth=300, top=400, align=center]

= INTSMRT-nnnn: Your Subtitle goes here

== WH-I-09: Get address information for Process Type 2010

Document version: {revnumber} - {last-update-label} {docdate}

toc::[]

With the fist line I activate the title-page. Then I add a logo to that. In my case it is an online image, but you can also use a file image. Then, for the = title I used the build-in subtitle command (separated by a colon).

This gives you this:

I hope this helps…

ralmqvist

Thanks a million - this works great!

Just one more question: How can I get rid of the document title in the upper right corner?

fblome

I am glad it works for you.

The document title in the upper right hand corner is part of the css. If you tell me your selected style I will create you a special version.

ralmqvist

I'm using a modified version of Manual. Have changed some colors and fonts to align with company policies. I tried to make some changes in the CCS to get rid of document title in the corner but have so far been unsuccessful. If you can point me to the place where to change it then update my own version.

This is the WHITEPAPER css stylesheet for adoc Studio.
It is based on the Base.css (see info.json) and it may can be also used 
as the basis for other factory stylesheets in adoc Studio.

This css file works as a supplement to the base styles.

It contains several changes to the base style:

- it redefines all fonts and colors
- it adds new icons for the notes
- other minor changes (see the comments)

Author: Frank Blome for ProjectWizards GmbH
Version: 1.0 from April 17, 2024
License: Distributed under the permissive MIT license

fblome

You know CSS, that is excellent!

In the lower part of the css file is a @media vivliostyle {. All contents here are for manipulating the pdf preview and export. In case you want to have just a centered page number you could copy this code snippet into that:

	@page 		
		toc:left, 
		toc-counted:left,
		preamble:left,
		preamble-counted:left,
		body:left, 
		body-counted:left,
		toc:right,
		toc-counted:right,
		preamble:right,
		preamble-counted:right,
		body:right, 
		body-counted:right {
		@top-left {
			content: "";
		}
		
		@top-right {
			content: "";
		}
		
		@bottom-left {
			content: "";
		}
		
		@bottom-right {
			content: "";
		}
		
		@bottom-center {
			content: " - " counter(counted-page) " - ";
		}
	}

But you could add also one of theses:

content: string(doctitle);
content: string(section1-title, first);
Or do some own stuff.

In general, it all follows the rules of paged media.

ralmqvist

Thanks! I will amuse myself with this during the weekend!

fblome

Whenever you have a question, we are ready to help.