Download the PHP package ceus-media/hydrogen-source-indexer without Composer

Hydrogen Source Indexer

In short: A tool to create an JSON index file for a collection of modules, usable with the Hydrogen framework.

Introduction

In the world of Hydrogen Framework, there are modules which can be installed from one or many module sources. A module source is a set of Hydrogen modules, produced, collected or maintained by a company or maybe you.

Modules can be installed using the tool Hymn. To be abled to scan for existing modules, a project has a hymn configuration file with registered sources. These sources need to be installed within the project using composer.

Since some libraries are collections with a higher number of modules, the indexing process can be made faster if the source has an index. This tool can create such an index by collecting all necessary information into a JSON file.

Usage

Let's say you have:

• a project using the Hydrogen Framework
• used composer to install the framework
• used composer to install the default module source Hydrogen Modules (optional)
• have developed own modules, which shall be reusable
• decided to create an own module source
• have collected your set of modules in a VCS repository (GitHub, GitLab etc.)
• created a composer file within the module source reposity
• made your module library availabe via Packagist (optional)

Installation

Check out your repository in dev mode into a working directory:

You now have your modules installed in the current directory.

Now, add the module source indexer as a package in dev mode:

Creation

To create the JSON index, you can do:

This will create the index.json in the directory.

Furthermore, you can create an HTML index (index.html) by:

You can add both files to the repository. While the JSON file can be used by Hymn, the HTML index is for usability and can be viewed in a browser to get an overview over the modules within the source.

Integration

During installation you have extended your composer file by the indexer package to be installed in dev mode. To shorten the execution of the indexer, you can extend your make file (Makefile) by:

Of course, you can change the target names according to your style.

Customization

Setting

The indexer comes with an empty property file (src/.index.ini) which can hold the main information about your module source. Copy this file to the root of your module source library and update the few lines by your needs.

Example:

These information will be used as headers for both index formats.

HTML

The indexer also comes with an HTML template file (src/.index.html) which will be used to create the HTML index. It contains placeholders which are replaced by settings and a generated module list.

Copy this file to the root of your module source library and update the few lines by your needs.

Doing this is recommended because some CSS and JavaScript assets from a Ceus Media CDN server are linked in the default template. If you use your own assets here, your index will not depend on Ceus Media resources.

Contributing

You like this indexer, are using it for your sources and have a better HTML template to commit? Or even better some improvements on the renderer classes? Please feel free to contribute your improvements by forking this repository and creating a pull request. Thank you!