https://github.com/uniqueck/asciidoctorj-office-extension

A AsciidoctorJ extension to convert excel sheets as table.
https://github.com/uniqueck/asciidoctorj-office-extension

asciidoc asciidoctor asciidoctor-extension asciidoctorj office

Last synced: 6 months ago
JSON representation

A AsciidoctorJ extension to convert excel sheets as table.

• Host: GitHub
• URL: https://github.com/uniqueck/asciidoctorj-office-extension
• Owner: uniqueck
• License: mit
• Created: 2019-09-29T16:57:47.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2023-12-05T22:39:00.000Z (almost 2 years ago)
• Last Synced: 2025-03-21T18:51:56.988Z (7 months ago)
• Topics: asciidoc, asciidoctor, asciidoctor-extension, asciidoctorj, office
• Language: Java
• Size: 105 KB
• Stars: 13
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.adoc
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
:icons: font

:version: 0.1.0

= AsciidoctorJ Office Extension

image:https://github.com/uniqueck/asciidoctorj-office-extension/actions/workflows/ci.yaml/badge.svg?branch=master["GitHub Actions", link="https://github.com/uniqueck/asciidoctorj-office-extension/actions/workflows/ci.yaml?branch=master"]

image:https://img.shields.io/badge/License-MIT-yellow.svg["MIT License", link="https://opensource.org/licenses/MIT"]

image:https://maven-badges.herokuapp.com/maven-central/de.uniqueck.asciidoctorj.extensions/asciidoctorj-office-extension/badge.svg?style=plastic[link="https://maven-badges.herokuapp.com/maven-central/de.uniqueck.asciidoctorj.extensions/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.

[subs="attributes, verbatim"]

[source, xml]

----

	org.asciidoctor

	asciidoctor-maven-plugin

	2.0.0-RC.1

	

		

			output-html

			generate-resources

			

				process-asciidoc

			

			

				html

			

		

	

	

		 

			de.uniqueck.asciidoctorj.extensions

			asciidoctorj-office-extension

			{version} 

		

	

----

<1> asciidoctorj-office-extension is added

<2> check for the latest version at https://search.maven.org/search?q=g:de.uniqueck.asciidoctorj.extensions%20AND%20a:asciidoctorj-office-extension[Maven Central]

== Microsoft Powerpoint Extension

=== slide macro

[source]

----

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

[source]

----

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