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     41           This is the main text of this page, which is boring.
    42     42       "}"})
    43     43   
    44     44   Why do you have to do that?  Eh...the vagaries of quoting in m4. 
    45     45   
    46     46   ## Creating blog/news posts
    47     47   
    48         -There is a shortcut to creating a new post: the "new-post" Make
           48  +There is a shortcut to creating a new post: the `new-post` Make
    49     49   target.  You must supply a value to the TITLE variable on the
    50     50   command-line when you use this target:
    51     51   
    52     52       $ make new-post TITLE="How amazingly simple"
           53  +
           54  +This will create a new post under the `src/news` sub-directory.  The
           55  +file name will include the current date and the hyphen-separated
           56  +title.  If you want your blog to be under a different directory (say,
           57  +`src/blog`), simply modify the `BLOG` variable in the Makefile.
    53     58   
    54     59   ## Generating the site
    55     60   
    56     61   Once you have created all of your pages, simply make the `all` target:
    57     62   
    58     63       $ make all
    59     64   
................................................................................
    83     88   the default design is rather minimalist.  Modify the files in the
    84     89   `templates` directory to change the site structure (particularly
    85     90   `main.html.m4`).  Notice all of those `m4_divert()` calls?  m4 uses
    86     91   those to determine where and how to merge the various templates.  You
    87     92   shouldn't need to change those.
    88     93   
    89     94   You can modify the css under the `src/css` sub-directory.
           95  +
           96  +The behavior of the Makefile is extremely hackable, so dig in!
    90     97   
    91     98   # Example Sites
    92     99   
    93    100   http://brandon.invergo.net
    94    101   
    95    102   # Contact
    96    103   
    97    104   Brandon Invergo <brandon [at] invergo [dot] net
    98    105   
    99    106   # Footnotes
   100    107   
   101    108   [1]  https://github.com/datagrok/m4-bakery
   102    109