Fix getnikola/nikola#2642 -- add not-a-blog links to Getting Started …

…and manual Signed-off-by: Chris Warrick <kwpolska@gmail.com>
getnikola · Jan 19, 2017 · 5579947 · 5579947
1 parent a664f8a
commit 5579947
Show file tree

Hide file tree

Showing 3 changed files with 28 additions and 3 deletions.
diff --git a/state_data.json b/state_data.json
@@ -1,3 +1,3 @@
 {
-  "last_deploy": "2017-01-13T09:23:46.417278"
+  "last_deploy": "2017-01-19T19:12:44.495741"
 }
diff --git a/stories/getting-started.html b/stories/getting-started.html
@@ -246,6 +246,8 @@ <h2 id="newpost">Step 4. Write your first post</h2>
         <p>To do that, you can just use <code class="gs-code gs-command">nikola new_post -e</code>. (The <code class="gs-code">-e</code> option will open the post in your text editor of choice; many more options are available)</p>
         <p>The command will create the file for you in the right place, with the metadata headers and a writing prompt.</p>
         <p>By default, Nikola creates posts in reStructuredText. You can read <a href="https://getnikola.com/quickstart.html">the reStructuredText Primer</a> to get accustomed to the syntax. You can also use many other input formats; to do this, your site needs <a href="#markup">some special configuration</a>.</p>
+        <h4>What if I don’t want a blog?</h4>
+        <p>If you want a static site that does not have any blog-related elements, see our <a href="https://getnikola.com/creating-a-site-not-a-blog-with-nikola.html">Creating a Site (Not a Blog) with Nikola</a> guide.
     </div>
     <div class="col-md-5">
         <pre class="gs-console">

diff --git a/stories/manual.txt b/stories/manual.txt
@@ -81,7 +81,7 @@ Nikola can't do:
 * Anything with forms, really (except for `comments <#comments-and-annotations>`_!)
 
 Keep in mind that "static" doesn't mean **boring**. You can have animations, slides
-or whatever fancy CSS/HTML5 thingie you like. It only means all that HTML is
+or whatever fancy CSS3/HTML5 thingie you like. It only means all that HTML is
 generated already before being uploaded. On the other hand, Nikola sites will
 tend to be content-heavy. What Nikola is good at is at putting what you write
 out there.
@@ -274,7 +274,6 @@ The post page is generated by default using the ``post.tmpl`` template, which yo
 to customize the output. You can also customize paths and the template filename
 itself — see `How does Nikola decide where posts should go?`
 
-
 Metadata fields
 ~~~~~~~~~~~~~~~
 
@@ -563,11 +562,27 @@ The ``new_post`` command supports some options:
       -F, --available-formats   List all available input formats
       -s                        Schedule the post based on recurrence rule
       -i ARG, --import=ARG      Import an existing file instead of creating a placeholder
+      -d, --date-path           Create post with date path (eg. year/month/day, see NEW_POST_DATE_PATH_FORMAT in config)
+
 
 The optional ``path`` parameter tells Nikola exactly where to put it instead of guessing from your config.
 So, if you do ``nikola new_post posts/random/foo.txt`` you will have a post in that path, with
 "foo" as its slug.
 
+The ``-d, --date-path`` option automates creation of ``year/month/day`` or
+similar directory structures. It can be enabled on a per-post basis, or you can
+use it for every post if you set ``NEW_POST_DATE_PATH = True`` in conf.py.
+
+.. code:: python
+
+   # Use date-based path when creating posts?
+   # Can be enabled on a per-post basis with `nikola new_post -d`.
+   # NEW_POST_DATE_PATH = False
+
+   # What format to use when creating posts with date paths?
+   # Default is '%Y/%m/%d', other possibilities include '%Y' or '%Y/%m'.
+   # NEW_POST_DATE_PATH_FORMAT = '%Y/%m/%d'
+
 Teasers
 ~~~~~~~
 
@@ -829,6 +844,14 @@ There are multiple configuration variables dedicated to each of the three taxono
 * ``HIDDEN_TAGS``. ``HIDDEN_CATEGORIES`` to make some tags/categories invisible in lists
 * ``POSTS_SECTION_FROM_META`` to use ``.. section:`` in posts instead of inferring paths from paths
 
+What if I don’t want a blog?
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If you want a static site that does not have any blog-related elements, see our
+`Creating a Site (Not a Blog) with Nikola`__ guide.
+
+__ https://getnikola.com/creating-a-site-not-a-blog-with-nikola.html
+
 Creating a Page
 ---------------