Git Product home page Git Product logo

playframework's Introduction

Gradle Play Plugin Build Status Latest release

Documentation

Development

Minimum requirements

To engage in the development of the plugin, follow the minimum requirements shown in the table below.

Tool Minimum Version

JDK

Oracle JDK or OpenJDK 8.x, anything higher won’t work with Scala 2.11

IDE

IntelliJ 2018.2 or higher

Executing the build

The plugin follows the standard conventions of a Java project modeled with Gradle. Furthermore, the project defines a task for running integration tests. To compile the code, execute all tests and build the plugin’s artifact, run the following command.

Linux & MacOSX

./gradlew build

Windows

gradlew.bat build

Working in the IDE

Importing the project into IntelliJ is straight forward. From the menu select File > Open…​ > Open as Project and point it to the build.gradle.kts file. In the following pop-up window, ensure that the default Gradle Wrapper is selected and "Create separate module per source set" is checked.

Release

The project currently doesn’t define a release process that can be triggered by running a single task. Following the process below.

  1. Update the release notes and release date in changelog file.

  2. Create a release on GitHub with the appropriate tag.

  3. Build and publish the Javadocs and the user guide by running the task gitPublishPush.

  4. Check that the https://github.com/gradle/playframework/actions?query=workflow%3A%22Create+Release%22 GitHub action is successful.

Generating documentation

The markup language for the user guide of this plugin is AsciiDoc. Documentation sources sit in the directory src/docs. To generate the HTML version of the plugin user guide, run the task asciidoctor. The generated HTML will be available in the directory build/asciidoc/html5.

Publishing documentation to GitHub Pages

Documentation (user guide & Javadocs) is hosted on GitHub Pages. To publish the documentation to GitHub Pages, execute the task gitPublishPush. Make sure to provide the required GitHub token by passing the system property -Dorg.ajoberstar.grgit.auth.username=$GH_TOKEN.

playframework's People

Contributors

bmuschko avatar big-guy avatar cstroe avatar jlleitschuh avatar marracuene avatar jprinet avatar eskatos avatar jospehchiu avatar tresat avatar jjohannes avatar pioterj avatar sineaggi avatar cmsr avatar rieske avatar cantsingh avatar artbristol avatar fushar avatar clemstoquart avatar gabizou avatar paulfridrick avatar wolfs avatar iaco86 avatar novokrest avatar

Watchers

بلال مسلوب avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.