diff options
Diffstat (limited to 'provider')
-rw-r--r-- | provider/css/default.css | 40 | ||||
-rw-r--r-- | provider/index.html | 8 | ||||
-rw-r--r-- | provider/index.md | 3 | ||||
-rw-r--r-- | provider/posts/blog-documentation.md | 9 | ||||
-rw-r--r-- | provider/posts/blog-rss.md | 43 | ||||
-rw-r--r-- | provider/posts/pwutil.md | 122 | ||||
-rw-r--r-- | provider/templates/default.html | 22 | ||||
-rw-r--r-- | provider/templates/index.html | 9 | ||||
-rw-r--r-- | provider/templates/post-list.html | 7 | ||||
-rw-r--r-- | provider/templates/tag.html | 2 |
10 files changed, 265 insertions, 0 deletions
diff --git a/provider/css/default.css b/provider/css/default.css new file mode 100644 index 0000000..7b89107 --- /dev/null +++ b/provider/css/default.css | |||
@@ -0,0 +1,40 @@ | |||
1 | body { | ||
2 | margin: auto; | ||
3 | padding-right: 1em; | ||
4 | padding-left: 1em; | ||
5 | font: normal 1.1em monospace; | ||
6 | max-width: 60em; | ||
7 | text-align: justify; | ||
8 | } | ||
9 | |||
10 | .display-math { | ||
11 | display: block; | ||
12 | margin-top: 0.2em; | ||
13 | margin-bottm: 0.2em; | ||
14 | text-align: center; | ||
15 | } | ||
16 | |||
17 | .inline-math { | ||
18 | display: inline; | ||
19 | } | ||
20 | |||
21 | a { | ||
22 | color: inherit; | ||
23 | } | ||
24 | |||
25 | p { | ||
26 | margin-bottom: 0 | ||
27 | } | ||
28 | |||
29 | p + p { | ||
30 | text-indent: 1.5em; | ||
31 | margin-top: 0; | ||
32 | } | ||
33 | |||
34 | pre { | ||
35 | margin-left: 1.5em; | ||
36 | } | ||
37 | |||
38 | p code { | ||
39 | font-style:italic; | ||
40 | } \ No newline at end of file | ||
diff --git a/provider/index.html b/provider/index.html new file mode 100644 index 0000000..8eb184f --- /dev/null +++ b/provider/index.html | |||
@@ -0,0 +1,8 @@ | |||
1 | $body$ | ||
2 | <ul> | ||
3 | $for(tags)$ | ||
4 | <li> | ||
5 | $body$ | ||
6 | </li> | ||
7 | $endfor$ | ||
8 | </ul> | ||
diff --git a/provider/index.md b/provider/index.md new file mode 100644 index 0000000..53a06bc --- /dev/null +++ b/provider/index.md | |||
@@ -0,0 +1,3 @@ | |||
1 | This is a blog. | ||
2 | It contains things. | ||
3 | Send other things to <blog@dirty-haskell.org> if you so choose. | ||
diff --git a/provider/posts/blog-documentation.md b/provider/posts/blog-documentation.md new file mode 100644 index 0000000..b0d4af6 --- /dev/null +++ b/provider/posts/blog-documentation.md | |||
@@ -0,0 +1,9 @@ | |||
1 | --- | ||
2 | title: On the Origin of dirty-haskell.org | ||
3 | published: 2015-03-12 | ||
4 | tags: Blog Software | ||
5 | --- | ||
6 | |||
7 | The software used is a trivially modified version of the one powering [math.kleen.org](http://math.kleen.org/lists/blog.html). | ||
8 | |||
9 | The title is without deeper meaning. | ||
diff --git a/provider/posts/blog-rss.md b/provider/posts/blog-rss.md new file mode 100644 index 0000000..095ff56 --- /dev/null +++ b/provider/posts/blog-rss.md | |||
@@ -0,0 +1,43 @@ | |||
1 | --- | ||
2 | title: dirty-haskell.org´s rss feeds | ||
3 | published: 2015-03-29 | ||
4 | tags: Blog Software | ||
5 | --- | ||
6 | |||
7 | I extended the software suite inherited from [math.kleen.org](http://math.kleen.org) to include support for rss feeds. | ||
8 | The heart of the issue is a ~80 line haskell script I chose to call, in a bout of creativity, "generate-rss.hs". | ||
9 | The script uses the [feed](http://hackage.haskell.org/package/feed-0.3.9.2) package. | ||
10 | |||
11 | generate-rss.hs gets passed a title and a list of paths below ./lists to incorporate as items. | ||
12 | It generates an empty feed structure, adds title and a (hardcoded) base url for RSS metadata, and iterates over the given paths — generating for each path an item to be included in the finished feed. | ||
13 | This procedure makes use of a state monad (StateT (Feed, Maybe ClockTime) IO ()) to sequentially add items to the feed and keep track of the modification/change time of the newest path examined. | ||
14 | Each item carries a title, an url, a date, and contents as follows: | ||
15 | |||
16 | - The date used is the modification/change time of the path supplied as a command line argument at the beginning of the program (usually a symbolic link in ./lists) — as such it is the time the post was linked into the particular list we´re generating a RSS feed for (this was not a deliberate design choice but a side effect of the canonical implementation — it was later decided that this behaviour was in fact the one expected all along). | ||
17 | - The url is generated by following, recursively, the trail of symbolic links starting in ./lists, assuming the final target is indeed in ./posts, and forming the filename of that target into a (hopefully) functional url in a hardcoded fashion. | ||
18 | - The title is extracted from the markdown file using a function shamelessly copied from extract-title.hs (The author wrote that one too, after all). | ||
19 | - The contents are read into Pandoc and rendered into [AsciiDoc](http://en.wikipedia.org/wiki/AsciiDoc) format (it seemed convenient at the time). | ||
20 | |||
21 | Along the way two helper functions were introduced — if an implementation of those already exists in Prelude or somewhere else common please mail in a comment: | ||
22 | |||
23 | ~~~ {.haskell} | ||
24 | (<->) :: [(a -> b)] -> a -> [b] | ||
25 | [] <-> _ = [] | ||
26 | (f:fs) <-> x = (f x:fs <-> x) | ||
27 | |||
28 | (<-->) :: [(a -> a)] -> a -> a | ||
29 | [] <--> x = x | ||
30 | (f:fs) <--> x = fs <--> (f x) | ||
31 | ~~~ | ||
32 | |||
33 | ## Update ## | ||
34 | |||
35 | ~~~ {.haskell} | ||
36 | import Control.Applicative ((<*>), pure) | ||
37 | |||
38 | (<->) fs = (<*>) fs . pure | ||
39 | |||
40 | (<-->) = flip $ foldl (.) id | ||
41 | ~~~ | ||
42 | |||
43 | Thanks, viktor. | ||
diff --git a/provider/posts/pwutil.md b/provider/posts/pwutil.md new file mode 100644 index 0000000..a4b3757 --- /dev/null +++ b/provider/posts/pwutil.md | |||
@@ -0,0 +1,122 @@ | |||
1 | --- | ||
2 | title: A Tool to Manage a Set of YAML Objects Representing Account Information — pwutil | ||
3 | published: 2015-04-07 | ||
4 | --- | ||
5 | |||
6 | A long time ago I wrote a bunch of scripts (first in bash, then zsh, and later perl) to manage a, sometimes encrypted, file containing account information I get asked to create and remember on a daily basis—accounts for shopping websites spring to mind. | ||
7 | |||
8 | [pwutil](git://git.yggdrasil.li/pwutil) is the newest iteration in this line of bunches of scripts. | ||
9 | |||
10 | ## Features | ||
11 | |||
12 | * Support for embedding common operation in any kind of record keeping | ||
13 | |||
14 | Thus support for almost any encryption known to man (with absolutely no online security), version control, and synchronisation | ||
15 | * [Human read- and writeable](https://en.wikipedia.org/wiki/YAML) backstore | ||
16 | * Machine parseable output | ||
17 | * [Command Line Interface](https://en.wikipedia.org/wiki/Command-line_interface)-only | ||
18 | * New accounts can be partially generated by user defined functions with out of the box support for [pwgen](http://sourceforge.net/projects/pwgen/) and SSH | ||
19 | |||
20 | ## Usage | ||
21 | |||
22 | ~~~ | ||
23 | pwget [<searchTerm> …] | ||
24 | Looks up and returns all accounts which contain any <searchTerm> anywhere in their representation — case insensitive. | ||
25 | |||
26 | pwadd [[--gen-<generator> [<generatorArgument> …] …] --] <identifier> [<attributeKey> <attributeValue> …] | ||
27 | Adds an account to the store — does not overwrite. | ||
28 | ~~~ | ||
29 | |||
30 | ## Documentation | ||
31 | |||
32 | I shall document the project in a partial and file-wise fashion—amendments available on request. | ||
33 | |||
34 | ### Structure | ||
35 | |||
36 | ~~~ {#DirTree} | ||
37 | pwutil | ||
38 | ├── default.nix | ||
39 | ├── PWAdd.hs | ||
40 | ├── PWGet.hs | ||
41 | ├── PWUtil | ||
42 | │ ├── Extra | ||
43 | │ │ ├── PWGen.hs | ||
44 | │ │ └── SSHCmd.hs | ||
45 | │ ├── Types.hs | ||
46 | │ └── Util.hs | ||
47 | ├── pwutil.hs | ||
48 | ├── PWUtil.hs | ||
49 | └── pwutil.nix | ||
50 | ~~~ | ||
51 | |||
52 | ### `pwutil.nix` | ||
53 | is a [nix](https://nixos.org/nix) expression allowing easy installation using the nix package manager. | ||
54 | A `~/.nixpkgs/config.nix` allowing one to do so might look thus: | ||
55 | |||
56 | ~~~ {.numberLines} | ||
57 | { | ||
58 | packageOverrides = pkgs: { | ||
59 | pwutil = pkgs.callPackage /path/to/pwutil.nix {}; | ||
60 | }; | ||
61 | } | ||
62 | ~~~ | ||
63 | |||
64 | The derivation takes some arguments (write those in `{}` above): | ||
65 | |||
66 | `main ? null` | ||
67 | ~ Overwrite `pwutil.hs` with a file path | ||
68 | |||
69 | `with<Package> ? false` | ||
70 | ~ `<Package>` is one of Pwgen, or Ssh a the current time. | ||
71 | If `true` wraps executables to have `$PATH` include `<Package>`. | ||
72 | |||
73 | ### `Types.hs` | ||
74 | |||
75 | Introducing `PW` (much as [xmonad](https://xmonad.org) did with `X`) is an easy way to keep track of the `PWConfig` without resorting to function arguments. | ||
76 | `BackStore` is our (new and improved) way of encapsulating store access in a totally customisable way—`plain`, which is essential `readFile` and `writeFile` as provided by `ByteString`, is provided for convenience in `Util.hs`. | ||
77 | `PWConfig` most importantly contains a definition of generators (called by passing `--gen-…` to `pwadd`). | ||
78 | |||
79 | ~~~ {#Types.hs .haskell .numberLines} | ||
80 | module PWUtil.Types ( | ||
81 | PW(..), | ||
82 | BackStore(..), | ||
83 | PWConfig(..), | ||
84 | Generator(..) | ||
85 | ) where | ||
86 | |||
87 | import Control.Monad.State | ||
88 | import qualified Data.Map as M | ||
89 | import Data.Yaml | ||
90 | import Data.ByteString | ||
91 | |||
92 | type PW = StateT PWConfig IO | ||
93 | |||
94 | data BackStore = BackStore | ||
95 | { readContents :: PW ByteString | ||
96 | , writeContents :: ByteString -> PW () | ||
97 | } | ||
98 | |||
99 | data PWConfig = PWConfig | ||
100 | { generators :: M.Map String Generator | ||
101 | , backstore :: BackStore | ||
102 | } | ||
103 | |||
104 | type Generator = [String] -> PW Value | ||
105 | ~~~ | ||
106 | |||
107 | |||
108 | ### `pwutil.hs` | ||
109 | |||
110 | is, in a [xmonad](http://xmonad.org) kind of way, the configuration file—the shipped default is reproduced below as a template for custom configs. | ||
111 | |||
112 | ~~~ {#pwutil.hs .haskell .numberLines} | ||
113 | import PWUtil | ||
114 | |||
115 | import System.FilePath ((</>)) | ||
116 | import System.Directory (getHomeDirectory) | ||
117 | |||
118 | main :: IO () | ||
119 | main = do | ||
120 | h <- getHomeDirectory | ||
121 | runPW (emptyConfig { backstore = plain (h </> "accounts.yaml") }) pwutil | ||
122 | ~~~ | ||
diff --git a/provider/templates/default.html b/provider/templates/default.html new file mode 100644 index 0000000..14497b2 --- /dev/null +++ b/provider/templates/default.html | |||
@@ -0,0 +1,22 @@ | |||
1 | <!DOCTYPE html> | ||
2 | <html$if(lang)$ lang="$lang$"$endif$> | ||
3 | <head> | ||
4 | <meta charset="utf-8"> | ||
5 | <meta name="generator" content="pandoc"> | ||
6 | <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"> | ||
7 | <title>$if(title)$$title$$endif$</title> | ||
8 | <style type="text/css">code{white-space: pre;}</style> | ||
9 | <!--[if lt IE 9]> | ||
10 | <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script> | ||
11 | <![endif]--> | ||
12 | <link rel="stylesheet" href="/css/default.css"> | ||
13 | </head> | ||
14 | <body> | ||
15 | $if(title)$ | ||
16 | <header> | ||
17 | <h1 class="title"><a href="/" title="dirty-haskell.org">dirty-haskell.org</a>: $title$</h1> | ||
18 | </header> | ||
19 | $endif$ | ||
20 | $body$ | ||
21 | </body> | ||
22 | </html> | ||
diff --git a/provider/templates/index.html b/provider/templates/index.html new file mode 100644 index 0000000..0eea806 --- /dev/null +++ b/provider/templates/index.html | |||
@@ -0,0 +1,9 @@ | |||
1 | $body$ | ||
2 | |||
3 | <ul> | ||
4 | $for(tags)$ | ||
5 | <li> | ||
6 | $body$ | ||
7 | </li> | ||
8 | $endfor$ | ||
9 | </ul> | ||
diff --git a/provider/templates/post-list.html b/provider/templates/post-list.html new file mode 100644 index 0000000..4d50d4d --- /dev/null +++ b/provider/templates/post-list.html | |||
@@ -0,0 +1,7 @@ | |||
1 | <ul> | ||
2 | $for(posts)$ | ||
3 | <li> | ||
4 | $if(ellipsis)$…$else$<a href="$url$">$title$</a>$endif$ | ||
5 | </li> | ||
6 | $endfor$ | ||
7 | </ul> | ||
diff --git a/provider/templates/tag.html b/provider/templates/tag.html new file mode 100644 index 0000000..8854cdd --- /dev/null +++ b/provider/templates/tag.html | |||
@@ -0,0 +1,2 @@ | |||
1 | <a href="$url$">$title$</a>$if(rss)$ (<a href="$rss$">RSS</a>)$endif$ | ||
2 | $body$ | ||