Changeset - 62309ac829c5
[Not reviewed]
0 1 0
Michael Guravage (guravage) - 11 years ago 2015-01-09 16:53:08
m.a.guravage@cwi.nl
Elaborated on how to archive a site.
1 file changed with 21 insertions and 3 deletions:
0 comments (0 inline, 0 general)
README.txt
Show inline comments
 
@@ -71,31 +71,49 @@ Previewing
 
Pelican has its own built-in server. You can invoke it with make; or
 
you can regenerate the HTML and serve it in one command::
 

	
 
    make html serve
 

	
 
The server uses port 8000 by default. After starting the server point
 
you browser to the url: localhost:8000.
 

	
 

	
 
Uploading the generated HTML to a server
 
----------------------------------------
 

	
 
The Pelican Makefile contains several targets for uploading its generated HTML. List all make's targets with::
 
The Pelican Makefile contains several targets for uploading its
 
generated HTML. List all make's targets with::
 

	
 
    make -n
 

	
 
To use rsync, edit the Makefile and customize the values of SSH_HOST,
 
SSH_USER anad SSH_Target_DIR.  Of course, this assumes you've already
 
spoken with someone at ITF to arrange a CWI vhost to host your site.
 
SSH_USER and SSH_Target_DIR.
 

	
 

	
 
If CWI is hosting your site, SSH_HOST and SSH_TARGET_DIR name the host
 
and document root configured for you by ITF staff.
 

	
 

	
 
Archiving your site
 
-------------------
 

	
 
The url from which you cloned the cwi-pelican-template repository is
 
called the clone's 'origin.' To archive your clone you should change
 
its origin to point to a new repository and push it there. For
 
example, if I had created a new repository at scm.cwi.nl named
 
itf-pelican-site, I could push my site there with the following two
 
commands::
 

	
 
git remote add origin https://guravage@scm.cwi.nl/ITF/itf-pelican-site
 
git push -u origin master
 

	
 

	
 
Creating new Pelican projects
 
-----------------------------
 

	
 
Pelican provides a scrip, appropriately named 'pelican-quickstart', to
 
help create new project hierarchies.  To use it, go to the projects
 
directory and invoke 'pelican-quickstart' at the command prompt. The
 
script will solicit your answers to a number of questions, and
 
generate your new project hierarchy accordingly.
 

	
 

	
0 comments (0 inline, 0 general)