xyntax v0.3.0

xyntax

Xyntax is a lightweight, developer-friendly JavaScript package and CLI tool that takes syntax highlighting to the next level. Xyntax dynamically parses your code during development, generating pre-highlighted strings. This means zero performance issues for your documentation sites.

Key Features

• Developer-friendly: Write the normal code with all the code completion features and other features that make speed up work.

• Dynamic Parsing: Code is parsed during development for real-time, browser-ready highlighting.

• Zero performance overhead: Minimal impact on performance, ensuring a smooth development experience.

• Theme Flexibility: Choose from a range of themes or customize your own for a personalized code highlighting.

• CLI support: Xyntax also has full support to be used via the CLI.

Installation

npm install -g xyntax

Code Examples

Assuming we would like to highlight the JSX code below in a documentation site using xyntax.

const hello = 'Hello World'

function MyButton() {
  return (
    <button>I'm a button</button>
  );
}

We would need to have the code below in somfile.xmd.js and parse via CLI using xyntax somfile.xmd.js path/to/project_root and insert the result into our project using // \insert my_identifier

somfile.xmd.js

//<xyntax path="./some_file_in_project_root" my_identifier>
{
const hello = 'Hello World'

function MyButton() {
  return (
    <button>I'm a button</button>
  );
}
}
//</xyntax>

In our actual project where we need the highlighted string, we could insert the result in this way.

/some_file_in_project_root

// some codes
export const codeExample = `` // \insert  my_identifier    
// some more codes

Usage Examples

Xyntax looks for files that ends with a .xmd.<extension> e.g. .xmd.js in the directory that is passed as source argument when working with the CLI or using in your JS/TS projects.

To parse a file via CLI,

xyntax path/to/source/file path/to/relative/directory

To parse a directory via CLI,

xyntax path/to/source/file path/to/relative/directory

To use in other JS/TS projects,

import {ParseString, ParseFile} from 'xyntax'

const projectDirectory = 'path/to/project_root'

// Highlight code
ParseString(code, projectDirectory);

// Or let xyntax find all .xmd.<extension> files in the sourceDirectory
const source = 'directory/containing/xyntax_files' // Could also be a xyntax_file
ParseFile(source, projectDirectory)

To use in a react project created with create-react-app

On the terminal, navigate to the project directory and xyntax --setup react

• Include all xyntax files anywhere in your project
• Do not include xyntax files in your production ready code, you only need the results which are inserted automatically by xyntax.

To use in a react project when you have access to the webpack.config.js

Add the code below to the webpack config's rules

{
    test:/(\.xmd\.[a-zA-Z]+)$/,
    exclude:/node_modules/,
    loader: require('xyntax/lib/loaders/react')
}

TODO

• Extend usage support to other popular frameworks
• Improve the highlighting engine (codes) to add more language highlighting