fpm/docs/index.rst

46 lines
1.7 KiB
ReStructuredText
Raw Permalink Normal View History

2021-11-10 14:27:24 +08:00
fpm - packaging made simple
===========================
2016-11-27 20:03:36 +08:00
.. note::
2021-08-03 13:37:02 +08:00
The documentation here is a work-in-progress; it is by no means extensive. If you want to contribute new docs or report problems, you are invited to do so on `the project issue tracker`_.
2016-11-27 20:03:36 +08:00
2021-11-10 14:27:24 +08:00
Welcome to the fpm documentation!
fpm is a tool which lets you easily create packages for Debian, Ubuntu, Fedora, CentOS, RHEL, Arch Linux, FreeBSD, macOS, and more!
fpm isn't a new packaging system, it's a tool to help you make packages for existing systems with less effort. It does this by offering a command-line interface to allow you to create packages easily. Here are some examples using fpm:
* ``fpm -s npm -t deb express`` -- Make a Debian package for the nodejs `express` library
* ``fpm -s cpan -t rpm Fennec`` -- Make an rpm for the perl Fennec module
* ``fpm -s dir -t pacman -n fancy ~/.zshrc`` -- Put your ~/.zshrc into an Arch Linux pacman package named "fancy"
* ``fpm -s python -t freebsd Django`` -- Create a FreeBSD package containing the Python Django library
* ``fpm -s rpm -t deb mysql.rpm`` -- Convert an rpm to deb
This project has a few important principles which guide development:
* Community: If a newbie has a bad time, it's a bug.
* Engineering: Make it work, make it right, then make it fast.
* Capabilities: If it doesn't do a thing today, we can make it do it tomorrow.
`Install fpm <installation.html>`_ and you'll quickly begin making packages for whatever you need!
2021-08-03 13:37:02 +08:00
You can view the changelog `here`_.
2016-11-27 20:03:36 +08:00
Table of Contents
-----------------
.. toctree::
2021-08-03 13:37:02 +08:00
:includehidden:
installation
getting-started
2021-10-21 13:05:34 +08:00
packaging-types
2021-08-03 13:37:02 +08:00
cli-reference
2021-11-10 14:27:24 +08:00
docker
2021-08-03 13:37:02 +08:00
contributing
2021-11-10 14:27:24 +08:00
changelog
2021-08-03 13:37:02 +08:00
2021-11-10 14:27:24 +08:00
.. _here: /changelog.html
2021-08-03 13:37:02 +08:00
.. _the project issue tracker: https://github.com/jordansissel/fpm/issues