codelicia/xulieta

Xulieta is a light php binary that lint documentation snippets

Fund package maintenance!
malukenho
EHER

0.1.5 2020-11-13 03:33 UTC

This package is auto-updated.

Last update: 2021-01-07 07:51:14 UTC


README

Xulieta

🌹 XULIETA

Xulieta is a light php binary that lint documentation snippets.

with love works everytime 68747470733a2f2f666f7274686562616467652e636f6d2f696d616765732f6261646765732f6d6164652d776974682d637261796f6e732e737667

Xulieta is a light php binary that find code snippets thought out documentation files — as for example *.md, *.markdown and *.rst — and lint the pieces of code, so you can find basic documentation errors.

NOTE: For now we just lint PHP code.

Installation

composer require codelicia/xulieta

Checking for errors

In order to lint the basics of documentation structure, one just needs to provide a path for a directory or file to be linted.

./vendor/bin/xulieta check:erromeu <directory>

Integration with GitHub Actions

We provide out of the box an output format that you can use to have automatic feedback from GitHub CI. That is done by specifying the checkstyle output and passing it to some external binary that does the commenting.

We recommend the usage of cs2pr.

./vendor/bin/xulieta check:erromeu <directory> --output=checkstyle | cs2pr

Commenting example

Codelicia\Xulieta

Advanced Configuration

Xulieta tries to find a .xulieta.xml file in the root of your project with the following configuration format:

<?xml version="1.0" encoding="UTF-8" ?>
<xulieta xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="./vendor/codelicia/xulieta/xulieta.xsd">

    <plugin>Codelicia\Xulieta\Plugin\PhpOnMarkdownPlugin</plugin>
    <plugin>Codelicia\Xulieta\Plugin\PhpOnRstPlugin</plugin>

    <exclude>vendor</exclude>
    <exclude>node_modules</exclude>
</xulieta>
  • plugin: listing of all formats handlers
  • exclude: excluded directory or files

Contributors ✨

Thanks goes to these wonderful people (emoji key):


Alexandre Eher

🚇 🚧 💻

Jefersson Nathan

🚇 🚧 💻

Airton Zanon

👀

This project follows the all-contributors specification. Contributions of any kind welcome!