bsorrentino / maven-confluence-plugin

Maven plugin that generates project's documentation directly to confluence allowing to keep in-sync project evolution with its documentation

Home Page:http://bsorrentino.github.io/maven-confluence-plugin/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Excerpt

nagper opened this issue · comments

commented

Hi there,

I wonder if marking text as an 'excerpt' is supported?

Thanks,
Peter

Hi @nagper do you mean markdown excerpt or what else ?

However markdown excerpt is not supported

commented

Hi,

A meant the confluence excerpt macro.

Regards,
Peter

Hi @nagper thanks for clarification

Actually every macro that can be written in confluence wiki could be used in this plugin.
Also in markdown you can use confluence macro (see Include custom macro(s) section)

for example you can use

{excerpt:hidden=true|atlassian-macro-output-type=BLOCK}
This is the *text* I want to reuse in other pages. This text is inside an Excerpt macro.
{excerpt}
commented

Hi @bsorrentino ,
oh, I have not seen this, sounds perfect, thank you!

commented

Hi @bsorrentino ,

I might misunderstand something but for me only the 1 liner macros works:

If i want to split them over several lines:

the server returns with the following error:
[ERROR] {"statusCode":500,"data":{"authorized":false,"valid":true,"allowedInReadOnlyMode":true,"errors":[],"successful":false},"message":"com.atlassian.confluence.content.render.xhtml.migration.exceptions.UnknownMacroMigrationException: The macro 'html' is unknown.","reason":"Internal Server Error"}

Am i doing something wrong?

Thanks,
Peter

Hi @nagper

could provide me an example ?

commented

Hi @bsorrentino ,

I've just seen, that my previous post did not work, i suspect i should have put my example in parenthesis.
(still i do not know how to make newlines appear...)
So here is the example:

This leads to the error message:
<!-- {excerpt:title=MyExcerpt} <there is a newline here> This is the content that I want to use as my excerpt. <there is a newline here> {excerpt} -->
(please insert a newline where i expliticly mentioned that there should be a newline there)

This works:
<!-- {excerpt:title=MyExcerpt} This is the content that I want to use as my excerpt. {excerpt} -->

Thanks,
Peter

Hi @nagper

I've deployed dev release 7.11-SNAPSHOT with fix. Please, take chance to test it an let me know if it works as expected

commented

Hi @bsorrentino ,

Thanks for your fix., It does work better, however there are still some glitches:

The formatting inside the excerpt falls apart.

Please try inserting a formatted text under or below the text in the excerpt, e.g.:
"### test"

As a result the string "text" will be converted to a list

Thanks,
Peter

Hi @nagper you right.

Simply the content on excerpt is not parsed as markdown but in wiki confluence format.

I'll working on

commented

Thanks a lot!

Hi @nagper

I've deployed a new dev release 7.11-SNAPSHOT with fix. Please, take chance to test it an let me know if it works as expected 🤞

commented

Hi @bsorrentino,

It seems to be working fine now, thank you!

Peter