README

Overview

Welcome! The src-run/cocoa-markdown-library package provides the following

Simple PHP-based markdown transformer library with support for custom runtimes and plugins.

Grouping

We use a Willy Wonka-inspired naming schema for our package group names. This package is part of the cocoa group, which is a collection of packages with a focus on "core reflection base classes" and related functionality.

You are welcome to research some useless details about this specific group if you have too much time on your hands.

JTT

This package represents a single project within a large collection of open-source code released under the "SR" namespace, comprised of many framework-agnostic libraries, a collection of Symfony bundles, as well as some one-off releases. This project is authored and maintained by:

Quick Start

Installation

Get the code by requiring it explicitly via the Composer CLI, or by editing your composer.json to reflect the dependency and updating your project requirements. For example, to explicitly require this project using the CLI, use the following command.

$ composer require src-run/cocoa-markdown-library

Alternatively, to add this project to your "composer.json" file, add the following to the "require" section.

require: {
	"src-run/cocoa-markdown-library": "dev-master"
}

Note: Is is not recommended to use the "dev-master" constraint. Realize that doing so could allow a release with backwards-incompatable, breaking changes to be pulled in. Instead, it is good practive to use semantic versioning and enter an explicit requirement. For example, to require version 1.0 you would use ^1.0.

Reference

API Docs

This package's API reference is available on our documentation website (see the "Reference" row of the table found in the "Additional Links" section below). All API documentation is automatically compiled against the master branch whenever a git push event occurs.

Static API reference for specific releases is planned and will be posted once this package has matured and reached the version 1 milestone.

The API reference websites detailed above are auto-generated using a reliable and well-developed CLI tool called Sami. It is rigorously and regularly tested and is used for some large-scale projects, such as the Symfony Full-Stack Framework <see: https://src.run/go/symfony-api>, as well some smaller projects, such as Twig <see: https://src.run/go/twig-api>. Refer to Sami's repository page to research usage in your own project.

Examples/Tutorials

Currently, there is no "human-written" documentation, outside of this README (which is itself generated from a template). Pending package stability, available man-hours, and an actual demand from external users, we may publish a Read the Docs page with official documentation, tutorials, and additional resources.

Contributing

Discussion

For general inquiries or to discuss a broad topic or idea, find "robfrawley" on Freenode. He is always happy to discuss language-level ideas, possible new directions for a project, emerging technologies, as well as the weather.

Issues

To report issues or request a new feature, use the project issue tracker. Include as much information as possible in any bug reports. Feel free to "ping" the topic if you don't get a response within a few days (sometimes Github notification e-mails fall through the cracks).

Code

You created additional functionality while utilizing this package? Wonderful: send it back upstream! Don't hesitate to submit a pull request! Your imagination and the requirements outlined within our CONTRIBUTING.md file are the only limitations.

License

This project is licensed under the MIT License, an FSF- and OSI-approved, GPL-compatible, permissive free software license. Review the LICENSE file distributed with this source code for additional information.

src-run / cocoa-markdown-library

Maintainers

Details