Compare commits

..

2 Enmetoj

Author SHA1 Message Date
Jaidyn Ann 17762ad3e4 Add “install” and “uninstall” tasks to Makefile 2024-06-01 22:07:02 -05:00
Jaidyn Ann b3a6062127 Add bare-bones man-page 2024-06-01 22:06:43 -05:00
2 changed files with 69 additions and 2 deletions

View File

@ -1,6 +1,11 @@
LISP ?= sbcl LISP ?= sbcl
all: clean build PREFIX ?= /usr/local
BINDIR ?= ${PREFIX}/bin
MANDIR ?= ${PREFIX}/share/man
MAN1DIR ?= ${MANDIR}/man1
all: build
clean: clean:
-rm mirror-img -rm mirror-img
@ -12,13 +17,23 @@ quicklisp:
--eval '(ql:add-to-init-file)' \ --eval '(ql:add-to-init-file)' \
--eval '(quit)' --eval '(quit)'
build: mirror-img:
$(LISP) --load mirror-img.asd \ $(LISP) --load mirror-img.asd \
--eval '(ql:quickload :mirror-img)' \ --eval '(ql:quickload :mirror-img)' \
--eval '(ql:quickload :mirror-img/unix)' \ --eval '(ql:quickload :mirror-img/unix)' \
--eval '(asdf:make :mirror-img/unix)' \ --eval '(asdf:make :mirror-img/unix)' \
--eval '(quit)' --eval '(quit)'
build: mirror-img
install: build
install -m 775 mirror-img ${BINDIR}
install -m 444 mirror-img.1 ${MAN1DIR}
uninstall:
rm ${BINDIR}/mirror-img
rm ${MAN1DIR}/mirror-img.1
test: test:
$(LISP) --load mirror-img.asd \ $(LISP) --load mirror-img.asd \
--eval '(ql:quickload :mirror-img)' \ --eval '(ql:quickload :mirror-img)' \

52
mirror-img.1 Normal file
View File

@ -0,0 +1,52 @@
.TH mirror\-img 1 2024-06-01 mirror-img
.SH NAME
mirror\-img \- localize a HTML file by downloading external resources
.SH SYNOPSIS
.SY mirror-img
.YS
\fBmirror-img\fR [ -h ] [ -b url ] [ -s url ] [ -d dir ] [ file ]
.SH DESCRIPTION
mirror-img is a command-line program that creates a “local” version of an HTML
file by mirroring its remote images, stylesheets, and other resources.
.SH OPTIONS
.IP "-h, --help"
Print the usage and exit.
.IP "-b, --base"
Define the “base” URL for output, corresponding to the downloads directory from
the perspective of the output HTML. In the output HTML, all mirrored resources
URLs will be replaced with this base URL followed by the files path relative to
the downloads directory.
For instance, if the downloads directory is /tmp/dl/ and the HTML file will be
output to /tmp/index.html, the base URL should be “dl/”.
Defaults to the --downloads (-d) directory.
.IP "-d, --downloads"
Set the directory into which mirrored files will be downloaded.
Defaults to “mirror/”.
.IP "-s, --source"
Provide the source URL to be used to resolve relative URLs in the input HTML.
If this option is not provided, resources with relative URLs will not be
mirrored at all. This should generally be set to the URL from which you
downloaded the HTML.
.SH REPORTING BUGS
Bugs can be reported to one of:
.IP
.UR https://hak.xwx.moe/jadedctrl/mirror-img/issues
.UE
.IP
.UR https://github.com/jadedctrl/mirror-img/issues
.UE
.SH SEE ALSO
.MR wget 1