This will place an HTML copy of a buffer on the web on a server
that the user has shell access on.

It's similar in purpose to services such as https://gist.github.com
or https://pastebin.com, but it's much simpler since it assumes the user
has an account on a publicly-accessible HTTP server. It uses `scp'
as its transport and uses Emacs' font-lock as its syntax
highlighter instead of relying on a third-party syntax highlighter
for which individual language support must be added one-by-one.

; Install

Requires htmlize; available at
https://github.com/hniksic/emacs-htmlize.  If htmlize is not
installed, by default it will fall back to Emacs's own htmlfontify.

Open the file and run `package-install-from-buffer', or put it on your
`load-path' and add these to your config:

(autoload 'scpaste "scpaste" nil t)
(autoload 'scpaste-region "scpaste" nil t)

Set `scpaste-http-destination' and `scpaste-scp-destination' to
appropriate values, and add this to your Emacs config:

(setq scpaste-http-destination "https://p.hagelb.org"
      scpaste-scp-destination "p.hagelb.org:p.hagelb.org")

If you have a different keyfile, you can set that, too:
(setq scpaste-scp-pubkey "~/.ssh/my_keyfile.pub")

If you use a non-standard ssh port, you can specify it by setting
`scpaste-scp-port'.

If you need to use alternative scp and ssh programs, you can set
`scpaste-scp' and `scpaste-ssh'. For example, scpaste works with the Putty
suite on Windows if you set these to pscp and plink, respectively.

Optionally you can set the displayed name for the footer and where
it should link to:

(setq scpaste-user-name "Technomancy"
      scpaste-user-address "https://technomancy.us/")

You can set `scpaste-async' to non-nil to run the upload in the background.

; Usage

M-x scpaste, enter a name, and press return. The name will be
incorporated into the URL by escaping it and adding it to the end
of `scpaste-http-destination'. The URL for the pasted file will be
pushed onto the kill ring.

You can autogenerate a splash page that gets uploaded as index.html
in `scpaste-http-destination' by invoking M-x scpaste-index. This
will upload an explanation as well as a listing of existing
pastes. If a paste's filename includes "private" it will be skipped.

You probably want to set up SSH keys for your destination to avoid
having to enter your password once for each paste. Also be sure the
key of the host referenced in `scpaste-scp-destination' is in your
known hosts file--scpaste will not prompt you to add it but will
simply hang and need you to hit C-g to cancel it.