Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Newer
Older
100644 68 lines (47 sloc) 2.55 kb
702e5fd @technomancy Initial commit.
authored
1 # SCPaste
2
3 This will place an HTML copy of a buffer on the web on a server to
4 which the user has SSH access.
5
6 It's similar in purpose to services such as http://paste.lisp.org or
7 http://rafb.net, but it's much simpler since it assumes the user has
8 an account on a publicly-accessible HTTP server. It uses `scp' as
9 its transport and uses Emacs' font-lock as its syntax highlighter
10 instead of relying on a third-party syntax highlighter for which
11 individual language support must be added one-by-one.
12
13 ## Installation
14
99ae7b3 @technomancy Version 0.6.3.
authored
15 Install via [Marmalade](https://marmalade-repo.org) or from source via
702e5fd @technomancy Initial commit.
authored
16 <tt>M-x package-install-from-buffer</tt>.
17
18 You'll need to configure your destination:
19
20 (setq scpaste-http-destination "http://p.hagelb.org"
21 scpaste-scp-destination "p.hagelb.org:p.hagelb.org")
22
23 `scpaste-scp-destination` should be an `scp`-accessible directory that
24 is also served over HTTP. `scpaste-http-destination` should be the URL
25 that corresponds to that directory.
26
7204d72 @Profpatsch Variable to specify a ssh keyfile.
Profpatsch authored
27 If you have a different keyfile, you can set that, too:
28
b7d93c3 @Profpatsch Merge remote-tracking branch 'remote/master'
Profpatsch authored
29 (setq scpaste-scp-pubkey "~/.ssh/my_keyfile.pub")
7204d72 @Profpatsch Variable to specify a ssh keyfile.
Profpatsch authored
30
5856e96 @Profpatsch Documentation and version bump.
Profpatsch authored
31 Optionally you can set the displayed name and where it should link to:
32
33 (setq scpaste-user-name "Technomancy"
34 scpaste-user-address "http://technomancy.us/")
35
702e5fd @technomancy Initial commit.
authored
36 You probably want to set up SSH keys for your destination to avoid
37 having to enter your password once for each paste. Also be sure the
38 key of the host referenced in `scpaste-scp-destination' is in your
39 known hosts file--scpaste will not prompt you to add it but will
40 simply hang.
41
42 ## Usage
43
44 `M-x scpaste`, (or `scpaste-region`) enter a name, and press
45 return. The name will be incorporated into the URL by escaping it and
46 adding it to the end of `scpaste-http-destination`. The URL for the
47 pasted file will be pushed onto the kill ring.
48
49 Two files will be uploaded: the HTML version as well as the raw
50 version. The HTML version simply has ".html" on the end of the name,
51 and it includes a link to the raw version at the bottom. (Customize
52 `scpaste-footer` to adjust the look of this link.)
53
54 You can autogenerate a splash page that gets uploaded as index.html
55 in `scpaste-http-destination` by invoking `M-x scpaste-index`. This
56 will upload an explanation as well as a listing of existing
57 pastes. If a paste's filename includes "private" it will be skipped.
58
c83096b @technomancy Push out some changes I had laying around. Switch to htmlfontify.
authored
59 ## Todo
60
61 * Automatically linkify URLs inside htmlfontify (stick it on the
62 hfy-opts group of misc tunables according to fledermaus)
63
702e5fd @technomancy Initial commit.
authored
64 ## Copyright
65
66 Copyright © 2008-2011 Phil Hagelberg. Distributed under the same terms
67 as GNU Emacs.
Something went wrong with that request. Please try again.