Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Chris Warrick <kwpolska@gmail.com>
- Loading branch information
Showing
8 changed files
with
136 additions
and
5 deletions.
There are no files selected for viewing
Binary file not shown.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,120 @@ | ||
====== | ||
Nikola | ||
====== | ||
|
||
-------------------------------- | ||
A Static Site and Blog Generator | ||
-------------------------------- | ||
|
||
:Version: Nikola v7.5.1 | ||
:Manual section: 1 | ||
:Manual group: User Commands | ||
|
||
SYNOPSIS | ||
======== | ||
|
||
Create an empty site (with a setup wizard): | ||
|
||
``nikola init mysite`` | ||
|
||
Create a post (inside the ``mysite`` directory): | ||
|
||
``nikola new_post`` | ||
|
||
Build the site: | ||
|
||
``nikola build`` | ||
|
||
Start the test server: | ||
|
||
``nikola serve`` | ||
|
||
See the site: | ||
|
||
``xdg-open http://127.0.0.1:8000/`` | ||
|
||
|
||
DESCRIPTION | ||
=========== | ||
|
||
Nikola is a static website and blog generator. The very short | ||
explanation is that it takes some texts you wrote, and uses them to | ||
create a folder full of HTML files. If you upload that folder to a | ||
server, you will have a rather full-featured website, done with little | ||
effort. | ||
|
||
It's original goal is to create blogs, but it supports most kind of | ||
sites, and can be used as a CMS, as long as what you present to the | ||
user is your own content instead of something the user generates. | ||
|
||
Nikola can do: | ||
|
||
* A blog | ||
* Your company's site | ||
* Your personal site | ||
* A software project's site | ||
* A book's site | ||
|
||
Since Nikola-based sites don't run any code on the server, there is no | ||
way to process user input in forms. | ||
|
||
Nikola can't do: | ||
|
||
* An Issue tracker | ||
* Anything with forms, really (except for comments!) | ||
|
||
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 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. | ||
|
||
COMMANDS | ||
======== | ||
|
||
The most basic commands needed to get by are: | ||
|
||
``nikola help`` | ||
get a list of commands, or help for a command | ||
``nikola version [--check]`` | ||
print version number | ||
``nikola init [-d|--demo] [-q|--quiet] folder`` | ||
initialize new site | ||
``nikola build`` | ||
build a site | ||
``nikola new_post`` | ||
create a new post | ||
``nikola new_page`` | ||
create a new page | ||
``nikola status [--list-drafts] [--list-modified] [--list-scheduled]`` | ||
show site and deployment status | ||
``nikola check [-v] (-l [--find-sources] [-r] | -f [--clean-files])`` | ||
check for dangling links or unknown files | ||
``nikola deploy [[preset [preset...]]`` | ||
deploy the site using the ``DEPLOY_COMMANDS`` setting | ||
``nikola github_deploy``` | ||
deploy the site to GitHub Pages | ||
``nikola serve [-p PORT] [-a ADDRESS] [-b|--browser] [-6|--ipv6]`` | ||
start development web server | ||
``nikola auto [-p PORT] [-a ADDRESS] [-b|--browser] [-6|--ipv6]`` | ||
start development web server with automated rebuilds and reloads | ||
``nikola plugin [options]`` | ||
manage plugins from the Plugins Index | ||
``nikola install_theme [name]`` | ||
install themes from the Themes Index | ||
|
||
Use ``nikola help`` to get a list of all commands. | ||
|
||
BUGS | ||
==== | ||
|
||
Issue Tracker: https://github.com/getnikola/nikola/issues | ||
|
||
SEE ALSO | ||
======== | ||
|
||
* The Nikola Website: https://getnikola.com/ | ||
* Handbook: https://getnikola.com/handbook.html | ||
* Support: https://getnikola.com/contact.html |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters