Hana 9e216da9ef go.mod: add go.mod and move pygments to third_party
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.
2021-02-15 16:45:26 -05:00

42 lines
1.4 KiB
ReStructuredText

Download and installation
=========================
The current release is version |version|.
Packaged versions
-----------------
You can download it `from the Python Package Index
<http://pypi.python.org/pypi/Pygments>`_. For installation of packages from
PyPI, we recommend `Pip <http://www.pip-installer.org>`_, which works on all
major platforms.
Under Linux, most distributions include a package for Pygments, usually called
``pygments`` or ``python-pygments``. You can install it with the package
manager as usual.
Development sources
-------------------
We're using the `Mercurial <http://selenic.com/mercurial>`_ version control
system. You can get the development source using this command::
hg clone http://bitbucket.org/birkenfeld/pygments-main pygments
Development takes place at `Bitbucket
<http://bitbucket.org/birkenfeld/pygments-main>`_, you can browse the source
online `here <http://bitbucket.org/birkenfeld/pygments-main/src>`_.
The latest changes in the development source code are listed in the `changelog
<http://bitbucket.org/birkenfeld/pygments-main/src/tip/CHANGES>`_.
.. Documentation
-------------
.. XXX todo
You can download the <a href="/docs/">documentation</a> either as
a bunch of rst files from the Mercurial repository, see above, or
as a tar.gz containing rendered HTML files:</p>
<p><a href="/docs/download/pygmentsdocs.tar.gz">pygmentsdocs.tar.gz</a></p>