Check-in [572b5b6a61]
Not logged in

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:clarify README
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1:572b5b6a6122827f2ca793130ef9d1045f783d39
User & Date: brandon@invergo.net 2013-02-19 17:52:31
Context
2013-02-19
17:52
make BLOG variable check-in: 549ad8e690 user: brandon@invergo.net tags: trunk
17:52
clarify README check-in: 572b5b6a61 user: brandon@invergo.net tags: trunk
17:47
fix missing paren in new_post template check-in: feb27ee76d user: brandon@invergo.net tags: trunk
Changes

Changes to README.md.

41
42
43
44
45
46
47
48
49
50
51
52





53
54
55
56
57
58
59
..
83
84
85
86
87
88
89


90
91
92
93
94
95
96
97
98
99
100
101
102
        This is the main text of this page, which is boring.
    "}"})

Why do you have to do that?  Eh...the vagaries of quoting in m4. 

## Creating blog/news posts

There is a shortcut to creating a new post: the "new-post" Make
target.  You must supply a value to the TITLE variable on the
command-line when you use this target:

    $ make new-post TITLE="How amazingly simple"






## Generating the site

Once you have created all of your pages, simply make the `all` target:

    $ make all

................................................................................
the default design is rather minimalist.  Modify the files in the
`templates` directory to change the site structure (particularly
`main.html.m4`).  Notice all of those `m4_divert()` calls?  m4 uses
those to determine where and how to merge the various templates.  You
shouldn't need to change those.

You can modify the css under the `src/css` sub-directory.



# Example Sites

http://brandon.invergo.net

# Contact

Brandon Invergo <brandon [at] invergo [dot] net

# Footnotes

[1]  https://github.com/datagrok/m4-bakery








|




>
>
>
>
>







 







>
>













41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
..
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
        This is the main text of this page, which is boring.
    "}"})

Why do you have to do that?  Eh...the vagaries of quoting in m4. 

## Creating blog/news posts

There is a shortcut to creating a new post: the `new-post` Make
target.  You must supply a value to the TITLE variable on the
command-line when you use this target:

    $ make new-post TITLE="How amazingly simple"

This will create a new post under the `src/news` sub-directory.  The
file name will include the current date and the hyphen-separated
title.  If you want your blog to be under a different directory (say,
`src/blog`), simply modify the `BLOG` variable in the Makefile.

## Generating the site

Once you have created all of your pages, simply make the `all` target:

    $ make all

................................................................................
the default design is rather minimalist.  Modify the files in the
`templates` directory to change the site structure (particularly
`main.html.m4`).  Notice all of those `m4_divert()` calls?  m4 uses
those to determine where and how to merge the various templates.  You
shouldn't need to change those.

You can modify the css under the `src/css` sub-directory.

The behavior of the Makefile is extremely hackable, so dig in!

# Example Sites

http://brandon.invergo.net

# Contact

Brandon Invergo <brandon [at] invergo [dot] net

# Footnotes

[1]  https://github.com/datagrok/m4-bakery