Skip to content

Commit 99dada4

Browse files
committed
Add docs.
1 parent 3c69ac6 commit 99dada4

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

44 files changed

+15530
-10
lines changed

Pipfile

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ wheel = "*"
99
flake8 = "*"
1010
tox = "*"
1111
coverage = "*"
12+
sphinx = "*"
1213

1314
[packages]
1415
tqdm = "*"

Pipfile.lock

Lines changed: 105 additions & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

README.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,15 @@ wikiwall
33
========
44
.. image:: https://travis-ci.com/kylepw/wikiwall.svg?branch=master
55
:target: https://travis-ci.com/kylepw/wikiwall
6+
.. image:: https://readthedocs.org/projects/wikiwall/badge/?version=latest
7+
:target: https://wikiwall.readthedocs.io/en/latest/?badge=latest
8+
:alt: Documentation Status
69
.. image:: https://coveralls.io/repos/github/kylepw/wikiwall/badge.svg?branch=master
710
:target: https://coveralls.io/github/kylepw/wikiwall?branch=master
811

912
*wikiwall* is a CLI that downloads a random image from Wikiart's Hi-Res page and sets it as your desktop background in macOS.
1013

11-
.. image:: https://github.com/kylepw/wikiwall/blob/master/example.gif
14+
.. image:: https://github.com/kylepw/wikiwall/blob/master/docs/_static/example.gif
1215
:align: center
1316

1417
Features
@@ -21,7 +24,6 @@ Requirements
2124
- Python 3.6 or higher
2225
- macOS
2326

24-
2527
Installation
2628
------------
2729
::
@@ -30,12 +32,11 @@ Installation
3032

3133
If you want, set your wallpaper to change every night with launchd: ::
3234

33-
$ git clone https://github.com/kylepw/wikiwall.git
34-
$ sed -i.bak -e "s|WIKIWALL|$(which wikiwall)|g" wikiwall/wikiwall.plist
35-
$ cp wikiwall/wikiwall.plist ~/Library/LaunchAgents
35+
$ git clone https://github.com/kylepw/wikiwall.git && cd wikiwall
36+
$ sed -i.bak -e "s|WIKIWALL|$(which wikiwall)|g" wikiwall.plist
37+
$ cp wikiwall.plist ~/Library/LaunchAgents
3638
$ launchctl load ~/Library/LaunchAgents/wikiwall.plist
3739

38-
3940
Usage
4041
-----
4142
::
@@ -57,8 +58,7 @@ Usage
5758

5859
Todo
5960
----
60-
- Add documentation to Sphinx.
61-
- Add support for other operating systems.
61+
- Set wallpaper on a desktop not currently being viewed.
6262
- Provide preview of image before setting as background.
6363

6464
License

docs/Makefile

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
# Minimal makefile for Sphinx documentation
2+
#
3+
4+
# You can set these variables from the command line.
5+
SPHINXOPTS =
6+
SPHINXBUILD = sphinx-build
7+
SOURCEDIR = .
8+
BUILDDIR = _build
9+
10+
# Put it first so that "make" without argument is like "make help".
11+
help:
12+
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
13+
14+
.PHONY: help Makefile
15+
16+
# Catch-all target: route all unknown targets to Sphinx using the new
17+
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
18+
%: Makefile
19+
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
11.5 KB
Binary file not shown.

docs/_build/doctrees/index.doctree

10.3 KB
Binary file not shown.

docs/_build/html/.buildinfo

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
# Sphinx build info version 1
2+
# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
3+
config: 30f6649263ddfebcbb85cdb5e2e7d644
4+
tags: 645f666f9bcd5a90fca523b33c5a78b7
15 MB
Loading
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
========
2+
wikiwall
3+
========
4+
.. image:: https://travis-ci.com/kylepw/wikiwall.svg?branch=master
5+
:target: https://travis-ci.com/kylepw/wikiwall
6+
.. image:: https://readthedocs.org/projects/wikiwall/badge/?version=latest
7+
:target: https://wikiwall.readthedocs.io/en/latest/?badge=latest
8+
:alt: Documentation Status
9+
.. image:: https://coveralls.io/repos/github/kylepw/wikiwall/badge.svg?branch=master
10+
:target: https://coveralls.io/github/kylepw/wikiwall?branch=master
11+
12+
*wikiwall* is a CLI that downloads a random image from Wikiart's Hi-Res page and sets it as your desktop background in macOS.
13+
14+
.. image:: /_static/example.gif
15+
16+
Features
17+
--------
18+
- Easily customize your desktop with new hi-res artwork from the command line.
19+
- Update your wallpaper periodically with your favorite scheduler.
20+
21+
Requirements
22+
------------
23+
- Python 3.6 or higher
24+
- macOS
25+
26+
Installation
27+
------------
28+
::
29+
30+
$ pip3 install wikiwall
31+
32+
If you want, set your wallpaper to change every night with launchd: ::
33+
34+
$ git clone https://github.com/kylepw/wikiwall.git && cd wikiwall
35+
$ sed -i.bak -e "s|WIKIWALL|$(which wikiwall)|g" wikiwall.plist
36+
$ cp wikiwall.plist ~/Library/LaunchAgents
37+
$ launchctl load ~/Library/LaunchAgents/wikiwall.plist
38+
39+
Usage
40+
-----
41+
::
42+
43+
$ wikiwall --help
44+
Usage: wikiwall [OPTIONS] COMMAND [ARGS]...
45+
46+
Set desktop background in macOS to random WikiArt image.
47+
48+
Options:
49+
--dest TEXT Download images to specified destination.
50+
--limit INTEGER Number of files to keep in download directory. Set to -1
51+
for no limit. Default is 10.
52+
--debug Show debugging messages.
53+
--help Show this message and exit.
54+
55+
Commands:
56+
show Show previous downloads in Finder.
57+
58+
Todo
59+
----
60+
- Set wallpaper on a desktop not currently being viewed.
61+
- Provide preview of image before setting as background.
62+
63+
License
64+
-------
65+
`MIT License <https://github.com/kylepw/wikiwall/blob/master/LICENSE>`_
66+
67+
.. toctree::
68+
:maxdepth: 1
673 Bytes
Loading

0 commit comments

Comments
 (0)