old-www/LDP/LG/lg-build/monthly

60 lines
2.6 KiB
Plaintext

PUBLISHING LINUX GAZETTE
Do this after you've formatted all the articles (see "articles" file in this
directory). This may look like a lot of steps but it goes fast. It should
take less than half an hour once you're used to it.
~ means /home/lg. ## means the issue number you're working on. All
programs are in ~/bin unless noted. The staging server is currently dilbert.
===== Publishing the issue =====
1) Copy ~/issue## to /LG/www/ on the staging server.
[You can later delete ~/issue## when you're sure the other copy is OK.]
2) Edit ~/data/config.yml . Change currentIssue to ##, and
nextIssueDate to the first of the following month.
3) Run "refresh". This rebuilds the database from the config files.
It takes a minute or so to complete. (Always run "refresh" after
modifying any files under ~/data/ .)
4) Rsync your ~/data to the staging server (same directory).
5) a) cd /LG/www/issue88/ for the next three steps.
c) Run "toc". This (re)generates index.html.
d) Run "twdt". This (re)generated TWDT.html and TWDT.txt.gz
e) Run "navbar". This (re)generates the links between articles.
6) The following steps must be on the staging server or where /LG is
NFS-mounted.
7) Run "frontpage". This (re)generates /LG/www/indes.html .
8) Run "sitemap". This (re)generated /LG/www/lg_index.html .
9) Run "authors". This (re)generates /LG/www/authors/* .
10) Run "rss >| /LG/www/lg.rss". This (re)generates the RSS file.
11) cd /LG/www
rm current
ln -s issue## current
(This is for people downloading to Palm pilots, etc.)
12) Make sure everything is world readable: "chmod +r -R /LG/www".
13) *** ON THE STAGING SERVER ***, run "/LG/scripts/ftpfiles.txt". This
updates the FTP files in /home/ftp/pub/lg/.
14) Wait for the push, or push /LG/www and the FTP files yourself.
15) Send the announcements.
a) Edit /home/lg/admin/announce.issue . Change the issue number and
month. Copy the TOC from /LG/www/issue##/TWDT.txt.gz .
b) E-mail the announcement to linux-announce@news.ornl.gov .
(That's the comp.os.linux.announce submission address.)
c) "ssh palace" and e-mail the announcment to lg-announce@ssc.com.
16) Tell heather@ssc.com she can copy the new LG articles into LJ.
===== Static files =====
The files in /LG/www not mentioned above or in the "files" file are static.
Edit the HTML directly as necessary.
===== Search list index =====
Dan has this running automatically, but if you need to do it manually,
as root on the staging server, do:
cd /var/lib/htdig
./build_and_push_dig_db_for_lg.sh
This takes about 20 minutes to run.