Skip to content
stritti edited this page Sep 5, 2017 · 9 revisions

This page will give you a short overview about the project and how it is built.

Overview

Log4js is currently one JavaScript file (in release). In the sources it is splitted into several files wich can be modified by any editor.

All the environment around will support us in having stable processes in

  • verify sources using jsLint
  • run unit tests to have stable versions using JSUnit
  • regenerate API documetnations from sources using JSDoc
  • generate the fully website for publishing
  • generate the archives for releases

Building Project

Core Javascript log4js library

To build the JavaScript library we use npm and grunt.

cd log4js
npm install
grunt build

Include then include the target/log4js.min.js file in your project.

Java addons

This section may be outdated

Coming from Java development, the Apache Ant is used building the project. Ant supports several targets which can be invoked.

To use Ant it is first required to have installed JavaTM first. After that, you can download Ant from the download section of the project pages. Please follow the given installation instructions there.

Main Ant Tasks

Task Description
clean Cleans the project from generated files.
dist distributes and compiles to target directory /build.
doc Create the JSDoc files to the directory /build/doc/api.
release Creates release archives.
download-dependencies tries to download all required libraries, like JSDoc, JSLint and extract them to the /toolsdirectory.

Coding Guidelines

There are only some coding guidelines:

  • Use tabs for intentions to save characters.
  • Use descreptive names
  • appropriate JSDoc is required
  • jsLint should not raise errors
  • in future all should be unit tested

Continuous Integration

Tracis CI is used to build all published changes: https://travis-ci.org/stritti/log4js

How can I contribute?

Every contribution is welcome! There are several ways. For example create a pull requestor provide updates for the project.