9e216da9ef
After go1.16, go will use module mode by default, even when the repository is checked out under GOPATH or in a one-off directory. Add go.mod, go.sum to keep this repo buildable without opting out of the module mode. > go mod init github.com/mmcgrana/gobyexample > go mod tidy > go mod vendor In module mode, the 'vendor' directory is special and its contents will be actively maintained by the go command. pygments aren't the dependency the go will know about, so it will delete the contents from vendor directory. Move it to `third_party` directory now. And, vendor the blackfriday package. Note: the tutorial contents are not affected by the change in go1.16 because all the examples in this tutorial ask users to run the go command with the explicit list of files to be compiled (e.g. `go run hello-world.go` or `go build command-line-arguments.go`). When the source list is provided, the go command does not have to compute the build list and whether it's running in GOPATH mode or module mode becomes irrelevant.
140 lines
5.9 KiB
ReStructuredText
140 lines
5.9 KiB
ReStructuredText
:orphan:
|
|
|
|
Pygments FAQ
|
|
=============
|
|
|
|
What is Pygments?
|
|
-----------------
|
|
|
|
Pygments is a syntax highlighting engine written in Python. That means, it will
|
|
take source code (or other markup) in a supported language and output a
|
|
processed version (in different formats) containing syntax highlighting markup.
|
|
|
|
Its features include:
|
|
|
|
* a wide range of common :doc:`languages and markup formats <languages>` is supported
|
|
* new languages and formats are added easily
|
|
* a number of output formats is available, including:
|
|
|
|
- HTML
|
|
- ANSI sequences (console output)
|
|
- LaTeX
|
|
- RTF
|
|
|
|
* it is usable as a command-line tool and as a library
|
|
* parsing and formatting is fast
|
|
|
|
Pygments is licensed under the BSD license.
|
|
|
|
Where does the name Pygments come from?
|
|
---------------------------------------
|
|
|
|
*Py* of course stands for Python, while *pigments* are used for coloring paint,
|
|
and in this case, source code!
|
|
|
|
What are the system requirements?
|
|
---------------------------------
|
|
|
|
Pygments only needs a standard Python install, version 2.6 or higher or version
|
|
3.3 or higher for Python 3. No additional libraries are needed.
|
|
|
|
How can I use Pygments?
|
|
-----------------------
|
|
|
|
Pygments is usable as a command-line tool as well as a library.
|
|
|
|
From the command-line, usage looks like this (assuming the pygmentize script is
|
|
properly installed)::
|
|
|
|
pygmentize -f html /path/to/file.py
|
|
|
|
This will print a HTML-highlighted version of /path/to/file.py to standard output.
|
|
|
|
For a complete help, please run ``pygmentize -h``.
|
|
|
|
Usage as a library is thoroughly demonstrated in the Documentation section.
|
|
|
|
How do I make a new style?
|
|
--------------------------
|
|
|
|
Please see the :doc:`documentation on styles <docs/styles>`.
|
|
|
|
How can I report a bug or suggest a feature?
|
|
--------------------------------------------
|
|
|
|
Please report bugs and feature wishes in the tracker at Bitbucket.
|
|
|
|
You can also e-mail the author or use IRC, see the contact details.
|
|
|
|
I want this support for this language!
|
|
--------------------------------------
|
|
|
|
Instead of waiting for others to include language support, why not write it
|
|
yourself? All you have to know is :doc:`outlined in the docs
|
|
<docs/lexerdevelopment>`.
|
|
|
|
Can I use Pygments for programming language processing?
|
|
-------------------------------------------------------
|
|
|
|
The Pygments lexing machinery is quite powerful can be used to build lexers for
|
|
basically all languages. However, parsing them is not possible, though some
|
|
lexers go some steps in this direction in order to e.g. highlight function names
|
|
differently.
|
|
|
|
Also, error reporting is not the scope of Pygments. It focuses on correctly
|
|
highlighting syntactically valid documents, not finding and compensating errors.
|
|
|
|
Who uses Pygments?
|
|
------------------
|
|
|
|
This is an (incomplete) list of projects and sites known to use the Pygments highlighter.
|
|
|
|
* `Wikipedia <http://en.wikipedia.org>`_
|
|
* `BitBucket <http://bitbucket.org/>`_, a Mercurial and Git hosting site
|
|
* `The Sphinx documentation builder <http://sphinx.pocoo.org/>`_, for embedded source examples
|
|
* `rst2pdf <http://code.google.com/p/rst2pdf/>`_, a reStructuredText to PDF converter
|
|
* `Codecov <http://codecov.io/>`_, a code coverage CI service
|
|
* `Trac <http://trac.edgewall.org/>`_, the universal project management tool
|
|
* `AsciiDoc <http://www.methods.co.nz/asciidoc/>`_, a text-based documentation generator
|
|
* `ActiveState Code <http://code.activestate.com/>`_, the Python Cookbook successor
|
|
* `ViewVC <http://viewvc.org/>`_, a web-based version control repository browser
|
|
* `BzrFruit <http://repo.or.cz/w/bzrfruit.git>`_, a Bazaar branch viewer
|
|
* `QBzr <http://bazaar-vcs.org/QBzr>`_, a cross-platform Qt-based GUI front end for Bazaar
|
|
* `Review Board <http://www.review-board.org/>`_, a collaborative code reviewing tool
|
|
* `Diamanda <http://code.google.com/p/diamanda/>`_, a Django powered wiki system with support for Pygments
|
|
* `Progopedia <http://progopedia.ru/>`_ (`English <http://progopedia.com/>`_),
|
|
an encyclopedia of programming languages
|
|
* `Bruce <http://r1chardj0n3s.googlepages.com/bruce>`_, a reStructuredText presentation tool
|
|
* `PIDA <http://pida.co.uk/>`_, a universal IDE written in Python
|
|
* `BPython <http://www.noiseforfree.com/bpython/>`_, a curses-based intelligent Python shell
|
|
* `PuDB <http://pypi.python.org/pypi/pudb>`_, a console Python debugger
|
|
* `XWiki <http://www.xwiki.org/>`_, a wiki-based development framework in Java, using Jython
|
|
* `roux <http://ananelson.com/software/roux/>`_, a script for running R scripts
|
|
and creating beautiful output including graphs
|
|
* `hurl <http://hurl.it/>`_, a web service for making HTTP requests
|
|
* `wxHTMLPygmentizer <http://colinbarnette.net/projects/wxHTMLPygmentizer>`_ is
|
|
a GUI utility, used to make code-colorization easier
|
|
* `Postmarkup <http://code.google.com/p/postmarkup/>`_, a BBCode to XHTML generator
|
|
* `WpPygments <http://blog.mirotin.net/?page_id=49>`_, and `WPygments
|
|
<https://github.com/capynet/WPygments>`_, highlighter plugins for WordPress
|
|
* `Siafoo <http://siafoo.net>`_, a tool for sharing and storing useful code and programming experience
|
|
* `D source <http://www.dsource.org/>`_, a community for the D programming language
|
|
* `dpaste.com <http://dpaste.com/>`_, another Django pastebin
|
|
* `Django snippets <http://www.djangosnippets.org/>`_, a pastebin for Django code
|
|
* `Fayaa <http://www.fayaa.com/code/>`_, a Chinese pastebin
|
|
* `Incollo.com <http://incollo.com>`_, a free collaborative debugging tool
|
|
* `PasteBox <http://p.boxnet.eu/>`_, a pastebin focused on privacy
|
|
* `hilite.me <http://www.hilite.me/>`_, a site to highlight code snippets
|
|
* `patx.me <http://patx.me/paste>`_, a pastebin
|
|
* `Fluidic <https://github.com/richsmith/fluidic>`_, an experiment in
|
|
integrating shells with a GUI
|
|
* `pygments.rb <https://github.com/tmm1/pygments.rb>`_, a pygments wrapper for Ruby
|
|
* `Clygments <https://github.com/bfontaine/clygments>`_, a pygments wrapper for
|
|
Clojure
|
|
* `PHPygments <https://github.com/capynet/PHPygments>`_, a pygments wrapper for PHP
|
|
|
|
|
|
If you have a project or web site using Pygments, drop me a line, and I'll add a
|
|
link here.
|
|
|