{"id":43876524,"url":"https://github.com/jmakeig/mlstyle","last_synced_at":"2026-02-06T14:44:55.454Z","repository":{"id":53477699,"uuid":"72791405","full_name":"jmakeig/mlstyle","owner":"jmakeig","description":"Code syntax highlighting and beautification for PowerPoint","archived":false,"fork":false,"pushed_at":"2021-03-29T17:04:21.000Z","size":23,"stargazers_count":1,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-09-01T22:34:19.590Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jmakeig.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-03T22:09:46.000Z","updated_at":"2020-06-13T07:50:37.000Z","dependencies_parsed_at":"2022-08-17T23:05:37.299Z","dependency_job_id":null,"html_url":"https://github.com/jmakeig/mlstyle","commit_stats":null,"previous_names":["jmakeig/pulchritude"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jmakeig/mlstyle","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmakeig%2Fmlstyle","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmakeig%2Fmlstyle/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmakeig%2Fmlstyle/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmakeig%2Fmlstyle/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jmakeig","download_url":"https://codeload.github.com/jmakeig/mlstyle/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jmakeig%2Fmlstyle/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29165080,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T14:37:12.680Z","status":"ssl_error","status_checked_at":"2026-02-06T14:36:22.973Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-02-06T14:44:54.763Z","updated_at":"2026-02-06T14:44:55.446Z","avatar_url":"https://github.com/jmakeig.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mlstyle\n\nA command-line code formatter that enforces MarkLogic corporate branding guidelines. \n\nGiven a snippet of code as a file or on your clipboard, `mlstyle` will turn that into pretty, syntax-highlighted text suitable for pasting into PowerPoint, or just about anywhere.\n\n_“Why would I want to use this?”_\n\nCode snippets in PowerPoint or Word (or anywhere outside of your editor) are very difficult to read without proper formatting. Moreover, one-off implementations tend to vary greatly in aesthetics and usability. `mlstyle` makes it so you don’t have to think about anything when it comes to formatting your code for presentation outside of your editor. It will format your code according to the official MarkLogic branding guidelines and usability standards.\n\n_“How does it work?”_\n\n`mlstyle` is a very thin wrapper around the popular Python-based [Pygments](http://pygments.org) library. Pygments supports hundreds of different languages and other data types and dozens of output formats. `mlstyle` implements the same [command-line interface as `pygmentize`](http://pygments.org/docs/cmdline/), the Pygments command-line utility. `mlstyle` seeds the appropriate defaults for the official MarkLogic branding guidelines. \n\n## Installation\n\n`mlstyle` is implemented in [Python](https://www.python.org). It was developed for Python3, but works with recent versions of Python 2 as well. macOS and Linux come with Python pre-installed. Windows users will have to [download](https://www.python.org) the runtime.\n\n```shell\npip install marklogicstyle\n```\n\nOn Windows, `pip.exe` is installed in the `Scripts` direcotry of the Python installation.\n\nIt is recommended, but not required that you install `mlstyle` into a virtual environemnt. If you’re installing globally, you may be required to use `sudo -H` or otherwise run the installation as an administrator _(not recommended)_.\n\n## Usage\n\n`mlstyle` is drop-in replacement for the [`pygmentize` command-line interface](http://pygments.org/docs/cmdline/) for Pygments.\n\n### OS X/macOS\n\nFor example, to generate an RTF document with a syntax-highlighted version of `myfile.xqy`,\n\n```shell\nmlstyle -f rtf myfile.xqy\n```\n\nPygments will determine the language from the file extension for most common extensions. For stdin or less common file types you can explicitly specify a lexer with the `-l` option, for example, `-l xquery`. For more information, see the [pygmentize documentation](http://pygments.org/docs/cmdline/).\n\nSend the highlighted text to Microsoft Word\n\n```shell\nmlstyle -f rtf myfile.xqy | open -f -b com.microsoft.Word\n```\n\nor to the clipboard to paste anywhere\n\n```shell\nmlstyle -f rtf myfile.xqy | pbcopy\n```\n\n### Windows \n\n```shell\nmlstyle -f rtf myfile.xqy \u003e formatted.rtf\n```\n\n\n--------------------------------------------------------\n\n## Development Set-up\n\nUse a Python 3 [virtual environment](https://docs.python.org/3/library/venv.html).\n\nFirst time,\n\n1. `mkdir env`\n1. `pyvenv env/python3` or `virtualenv env/python2` for Python 2\n\nIn a virgin shell,\n\n1. `source env/python3/bin/activate` to activate the environment (and `deactivate` to deactivate it)\n1. `pip install -r requirements.txt`\n1. `python setup.py develop`\n\n## Distribution\n\nFirst time, [manually register on the PyPi web site](https://pypi.python.org/pypi?%3Aaction=submit_form).\n\n1. `python setup.py sdist upload`\n\nSee also [“Packaging and Distributing Projects”](https://packaging.python.org/distributing/#uploading-your-project-to-pypi).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmakeig%2Fmlstyle","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjmakeig%2Fmlstyle","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjmakeig%2Fmlstyle/lists"}