Skip to content
MODX documentation in markdown
Branch: 2.x
Clone or download
Latest commit 49a0bcb May 19, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Some more work on the issue templates, adding a new request one Apr 8, 2019
convert Run export of the revolution extras Apr 5, 2019
en Add package-build page May 19, 2019
nl Update url to modxorg May 5, 2019
ru Add package-build page May 19, 2019
.editorconfig Start translate index.md Mar 2, 2019
.gitignore Import documentation from MODX to Markdown Dec 14, 2017
.mdlrc Add .mdlrc that can be used for validating the markdown syntax with h… Apr 5, 2019
README.md
redirects.json Batch fix tables, some links, and various small formatting issues Apr 29, 2019

README.md

MODX Documentation

Contributors Contributors Slack Chat

This repository contains the MODX documentation in Markdown format. This is part of an effort to replace the official documentation with a markdown-system that allows easier management and more community involvement.

This new documentation is currently available from docs.modx.org

New documentation goals

The new documentation (content) should allow:

  • Major Version-specific documentation, based on git branches. MODX 3 will need to have its own documentation branch that can be worked on independently from MODX 2, with the possibility for git merges to synchronise shared changes.
  • Multilingual capabilities. All current documentation is in a /en/ folder, which should allow other languages to be added.

Serving up the documentation

The beauty of markdown is that it is independent from specific technologies or tools. This repository therefore only has the markdown content. How this content is served up to users, is handled in a different repository.

Discussion

Please feel free to open an issue for bad markdown conversions or discussion points. There is also a relevant #documentation channel on the MODX Community Slack.

The Conversion (Old)

The current docs site is powered by MODX, with a front-end editing utility. Documentation content is stored as HTML, while the goal is to use Markdown instead.

I've been provided with a copy of the MODX database to ease the conversion so we don't have to scrape or parse more than necessary.

To run the conversion, a convert script is included in /convert/. This uses a composer dependency, so composer install in that directory before running it (from the command line) with php do-it.php. The actual conversion script is in convert/Converter.php. It basically connects to MODX, assuming config.core.php in the project root to point it to a valid MODX installation, and then recursively (by parent) loops over all resources and converts the resource content and meta data into a markdown file. The markdown file is placed under /en/, with the naming matching the resource alias/parents.

Improvements to the conversion script are welcome.

You can’t perform that action at this time.