Skip to content
Permalink
Browse files
Fix getnikola/nikola#2642 -- add not-a-blog links to Getting Started …
…and manual

Signed-off-by: Chris Warrick <kwpolska@gmail.com>
  • Loading branch information
Kwpolska committed Jan 19, 2017
1 parent a664f8a commit 557994737ae7b8c1b47b3c356851bcf8b9313ec8
Showing with 28 additions and 3 deletions.
  1. +1 −1 state_data.json
  2. +2 −0 stories/getting-started.html
  3. +25 −2 stories/manual.txt
@@ -1,3 +1,3 @@
{
"last_deploy": "2017-01-13T09:23:46.417278"
"last_deploy": "2017-01-19T19:12:44.495741"
}
@@ -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">
@@ -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
---------------

0 comments on commit 5579947

Please sign in to comment.