adobe/aem-importer-markdown-maven-plugin

Name: aem-importer-markdown-maven-plugin

Owner: Adobe Systems Incorporated

Description: AEM Importer for Markdown Maven Plugin

Created: 2018-01-11 08:38:26.0

Updated: 2018-05-13 18:48:48.0

Pushed: 2018-01-11 11:33:08.0

Homepage: null

Size: 25

Language: Java

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

AEM Importer for Markdown Maven Plugin

• Are you using Adobe Experience Manager?
• Are you using Apache Maven?
• Do you write (or generate) documentation in Markdown?
• Would you like to serve your Markdown documentation using AEM?
• Would you like to integrate the conversion process into your Maven build?

If you've answered all questions with yes, you've come to the right place.

This Maven plugin allows the creation of AEM packages from Markdown files.

Building

n clean install

Configuring

Add following stuff to your pom.xml

uild>
<plugins>
  <plugin>
    <groupId>com.adobe.aem</groupId>
    <artifactId>aem-importer-markdown-maven-plugin</artifactId>
    <version>1.11-SNAPSHOT</version>
    <configuration>
      <root>/content/udp/en/open/source/markdown-aem-maven</root>
      <rootType>udp/components/structure/githubdocumentation</rootType>
      <type>udp/components/structure/githubdocumentation</type>
      <pageTemplate>/apps/udp/templates/importedgithubpage</pageTemplate>
      <rootTemplate>/apps/udp/templates/githubdocumentation</rootTemplate>
      <branches>
        <master>path/to/master/checkout</master>
        <develop>path/to/develop/checkout</develop>
      </branches>
      <pages>
        <page>README.md</page>
        <page>docs*</page>
      </pages>  
    </configuration>
    <executions>
      <execution>
        <phase>generate-sources</phase>
        <goals>
          <goal>package</goal>
        </goals>
      </execution>
    </executions>
  </plugin>
</plugins>
build>

Parameters

• root: this is the path in AEM where your pages are being created. Make sure not to overwrite important existing content
• rootType: this is the sling:resourceType of the root page
• type: this is the sling:resourceType for all imported pages
• pageTemplate: page template path for the root page
• rootTemplate: page template path for imported pages
• branches: key-value pairs of branches and the root path of the local checkout
• docs: list of patterns of paths or file names that should be imported

Running

n aem-importer-markdown-maven-plugin:package

Releasing

This project is configured to deploy to Maven Central via Sonatype OSS. If you want to release yourself, first create an account in the Sonatype JIRA and open a new issue, requesting access to the group com.adobe.aem. Please reference trieloff and adobe-bot in your request, so that we can confirm your permission.

In the next step, edit your ~/.m2/settings.xml to include a new <server> section:

tings>
ervers>
<server>
  <id>ossrh</id>
  <username><!-- your Sonatype username --></username>
  <password><!-- your Sonatype password --></password>
</server>
servers>
ttings>

Deploying a Build

To deploy a build, use the pre-configured Maven Release Plugin with following commands:

n release:clean release:prepare
n release:perform

Releases can only be performed when you

• have commit permissions on this repository
• have access to the Sonatype group

License/Copyright

Copyright 2017 Adobe Systems Incorporated. All rights reserved. This file is licensed to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0