uniqueck/asciidoctorj-office-extension

A AsciidoctorJ extension to convert excel sheets as table.

AsciidoctorJ Office Extension

This AsciidoctorJ extension helps you to use office documents in your asciidoc toolchain.

Installation

To use this extension declare it as a dependency in asciidoctor-maven-plugin configuration.

<plugin>
	<groupId>org.asciidoctor</groupId>
	<artifactId>asciidoctor-maven-plugin</artifactId>
	<version>2.0.0-RC.1</version>
	<executions>
		<execution>
			<id>output-html</id>
			<phase>generate-resources</phase>
			<goals>
				<goal>process-asciidoc</goal>
			</goals>
			<configuration>
				<backend>html</backend>
			</configuration>
		</execution>
	</executions>
	<dependencies>
		<dependency> <!--(1)-->
			<groupId>de.uniqueck.asciidoctorj.extensions</groupId>
			<artifactId>asciidoctorj-office-extension</artifactId>
			<version>0.1.0</version> <!--(2)-->
		</dependency>
	</dependencies>
</plugin>

1. asciidoctorj-office-extension is added

2. check for the latest version at Maven Central

Microsoft Powerpoint Extension

slide macro

slide::/path/to/powerpointFile.pptx[slideNumber=1]

This macro generate an image from the first slide from the given powerpointFile.pptx and embedded it in your asciidoc document.

Currently only Microsofts *.pptx format is supported.

Attributes

• slides-dir-name output directory name for converted images from slides

Microsoft Excel Extension

excel macro

excel::/path/to/excel.(xlsx|xls)[sheetName=Table1]

This macro generate a asciidoc table based on your excel sheet. Currently supported formats are xls and xlsx.

Attributes

• sheetName name of sheet to be converted to AsciiDoc table

asciidoctorj-office-extension's Issues

Excel row- & col-span

I just stumbled upon this project and I have to say I think it is great and quite helpful!
I will reference it from docToolchain asap.

I've also seen that you noted down as open issues the implementation of row- and col-span for excel.
Have you checked out the code in docToolchain for the exportExcel-Task?

https://github.com/docToolchain/docToolchain/blob/master/scripts/exportExcel.gradle

It is capable of handling row- and col-spans, alignments, col-width and background colors.

Provide a changelog

Add announcement for release to zulip

Gradle?

Have you already tried to get this up and running with gradle?
I ask, because we currently to to integrate this into docToolchain. And it seems a simple reference to your lib isn't enough...

Push release to github

Migrate to maven central

Migrate from bintray to maven central to releasing new versions of this extension.
Issue on sonatype: https://issues.sonatype.org/browse/OSSRH-66709