mirror of https://github.com/python/cpython
578 lines
15 KiB
Python
578 lines
15 KiB
Python
"""FAQ Wizard customization module.
|
|
|
|
Edit this file to customize the FAQ Wizard. For normal purposes, you
|
|
should only have to change the FAQ section titles and the small group
|
|
of parameters below it.
|
|
|
|
"""
|
|
|
|
# Titles of FAQ sections
|
|
|
|
SECTION_TITLES = {
|
|
# SectionNumber : SectionTitle; need at least one entry
|
|
1: "General information and availability",
|
|
}
|
|
|
|
# Parameters you definitely want to change
|
|
|
|
SHORTNAME = "Generic" # FAQ name with "FAQ" omitted
|
|
PASSWORD = "" # Password for editing
|
|
OWNERNAME = "FAQ owner" # Name for feedback
|
|
OWNEREMAIL = "nobody@anywhere.org" # Email for feedback
|
|
HOMEURL = "http://www.python.org" # Related home page
|
|
HOMENAME = "Python home" # Name of related home page
|
|
RCSBINDIR = "/usr/local/bin/" # Directory containing RCS commands
|
|
# (must end in a slash)
|
|
|
|
# Parameters you can normally leave alone
|
|
|
|
MAXHITS = 10 # Max #hits to be shown directly
|
|
COOKIE_LIFETIME = 28*24*3600 # Cookie expiration in seconds
|
|
# (28*24*3600 = 28 days = 4 weeks)
|
|
PROCESS_PREFORMAT = 1 # toggle whether preformatted text
|
|
# will replace urls and emails with
|
|
# HTML links
|
|
|
|
# Markers appended to title to indicate recently change
|
|
# (may contain HTML, e.g. <IMG>); and corresponding
|
|
|
|
MARK_VERY_RECENT = " **" # Changed very recently
|
|
MARK_RECENT = " *" # Changed recently
|
|
DT_VERY_RECENT = 24*3600 # 24 hours
|
|
DT_RECENT = 7*24*3600 # 7 days
|
|
|
|
EXPLAIN_MARKS = """
|
|
<P>(Entries marked with ** were changed within the last 24 hours;
|
|
entries marked with * were changed within the last 7 days.)
|
|
<P>
|
|
"""
|
|
|
|
# Version -- don't change unless you edit faqwiz.py
|
|
|
|
WIZVERSION = "1.0.4" # FAQ Wizard version
|
|
|
|
import os, sys
|
|
if os.name in ['nt',]:
|
|
# On NT we'll probably be running python from a batch file,
|
|
# so sys.argv[0] is not helpful
|
|
FAQCGI = 'faq.bat' # Relative URL of the FAQ cgi script
|
|
# LOGNAME is not typically set on NT
|
|
os.environ[ 'LOGNAME' ] = "FAQWizard"
|
|
else:
|
|
# This parameter is normally overwritten with a dynamic value
|
|
FAQCGI = 'faqw.py' # Relative URL of the FAQ cgi script
|
|
FAQCGI = os.path.basename(sys.argv[0]) or FAQCGI
|
|
del os, sys
|
|
|
|
# Perl (re module) style regular expression to recognize FAQ entry
|
|
# files: group(1) should be the section number, group(2) should be the
|
|
# question number. Both should be fixed width so simple-minded
|
|
# sorting yields the right order.
|
|
|
|
OKFILENAME = r"^faq(\d\d)\.(\d\d\d)\.htp$"
|
|
|
|
# Format to construct a FAQ entry file name
|
|
|
|
NEWFILENAME = "faq%02d.%03d.htp"
|
|
|
|
# Load local customizations on top of the previous parameters
|
|
|
|
try:
|
|
from faqcust import *
|
|
except ImportError:
|
|
pass
|
|
|
|
# Calculated parameter names
|
|
|
|
COOKIE_NAME = SHORTNAME + "-FAQ-Wizard" # Name used for Netscape cookie
|
|
FAQNAME = SHORTNAME + " FAQ" # Name of the FAQ
|
|
|
|
# ----------------------------------------------------------------------
|
|
|
|
# Anything below this point normally needn't be changed; you would
|
|
# change this if you were to create e.g. a French translation or if
|
|
# you just aren't happy with the text generated by the FAQ Wizard.
|
|
|
|
# Most strings here are subject to substitution (string%dictionary)
|
|
|
|
# RCS commands
|
|
|
|
import os
|
|
if os.name in ['nt', ]:
|
|
SH_RLOG = RCSBINDIR + "rlog %(file)s < NUL"
|
|
SH_RLOG_H = RCSBINDIR + "rlog -h %(file)s < NUL"
|
|
SH_RDIFF = RCSBINDIR + "rcsdiff -r%(prev)s -r%(rev)s %(file)s < NUL"
|
|
SH_REVISION = RCSBINDIR + "co -p%(rev)s %(file)s < NUL"
|
|
### Have to use co -l, or the file is not marked rw on NT
|
|
SH_LOCK = RCSBINDIR + "co -l %(file)s < NUL"
|
|
SH_CHECKIN = RCSBINDIR + "ci -u %(file)s < %(tfn)s"
|
|
else:
|
|
SH_RLOG = RCSBINDIR + "rlog %(file)s </dev/null 2>&1"
|
|
SH_RLOG_H = RCSBINDIR + "rlog -h %(file)s </dev/null 2>&1"
|
|
SH_RDIFF = RCSBINDIR + "rcsdiff -r%(prev)s -r%(rev)s %(file)s </dev/null 2>&1"
|
|
SH_REVISION = RCSBINDIR + "co -p%(rev)s %(file)s </dev/null 2>&1"
|
|
SH_LOCK = RCSBINDIR + "rcs -l %(file)s </dev/null 2>&1"
|
|
SH_CHECKIN = RCSBINDIR + "ci -u %(file)s <%(tfn)s 2>&1"
|
|
del os
|
|
|
|
# Titles for various output pages (not subject to substitution)
|
|
|
|
T_HOME = FAQNAME + " Wizard " + WIZVERSION
|
|
T_ERROR = "Sorry, an error occurred"
|
|
T_ROULETTE = FAQNAME + " Roulette"
|
|
T_ALL = "The Whole " + FAQNAME
|
|
T_INDEX = FAQNAME + " Index"
|
|
T_SEARCH = FAQNAME + " Search Results"
|
|
T_RECENT = "What's New in the " + FAQNAME
|
|
T_SHOW = FAQNAME + " Entry"
|
|
T_LOG = "RCS log for %s entry" % FAQNAME
|
|
T_REVISION = "RCS revision for %s entry" % FAQNAME
|
|
T_DIFF = "RCS diff for %s entry" % FAQNAME
|
|
T_ADD = "Add an entry to the " + FAQNAME
|
|
T_DELETE = "Deleting an entry from the " + FAQNAME
|
|
T_EDIT = FAQNAME + " Edit Wizard"
|
|
T_REVIEW = T_EDIT + " - Review Changes"
|
|
T_COMMITTED = T_EDIT + " - Changes Committed"
|
|
T_COMMITFAILED = T_EDIT + " - Commit Failed"
|
|
T_CANTCOMMIT = T_EDIT + " - Commit Rejected"
|
|
T_HELP = T_EDIT + " - Help"
|
|
|
|
# Generic prologue and epilogue
|
|
|
|
PROLOGUE = '''
|
|
<HTML>
|
|
<HEAD>
|
|
<TITLE>%(title)s</TITLE>
|
|
</HEAD>
|
|
|
|
<BODY BACKGROUND="http://www.python.org/pics/RedShort.gif"
|
|
BGCOLOR="#FFFFFF"
|
|
TEXT="#000000"
|
|
LINK="#AA0000"
|
|
VLINK="#906A6A">
|
|
<H1>%(title)s</H1>
|
|
'''
|
|
|
|
EPILOGUE = '''
|
|
<HR>
|
|
<A HREF="%(HOMEURL)s">%(HOMENAME)s</A> /
|
|
<A HREF="%(FAQCGI)s?req=home">%(FAQNAME)s Wizard %(WIZVERSION)s</A> /
|
|
Feedback to <A HREF="mailto:%(OWNEREMAIL)s">%(OWNERNAME)s</A>
|
|
|
|
</BODY>
|
|
</HTML>
|
|
'''
|
|
|
|
# Home page
|
|
|
|
HOME = """
|
|
<H2>Search the %(FAQNAME)s:</H2>
|
|
|
|
<BLOCKQUOTE>
|
|
|
|
<FORM ACTION="%(FAQCGI)s">
|
|
<INPUT TYPE=text NAME=query>
|
|
<INPUT TYPE=submit VALUE="Search"><BR>
|
|
<INPUT TYPE=radio NAME=querytype VALUE=simple CHECKED>
|
|
Simple string
|
|
/
|
|
<INPUT TYPE=radio NAME=querytype VALUE=regex>
|
|
Regular expression
|
|
/<BR>
|
|
<INPUT TYPE=radio NAME=querytype VALUE=anykeywords>
|
|
Keywords (any)
|
|
/
|
|
<INPUT TYPE=radio NAME=querytype VALUE=allkeywords>
|
|
Keywords (all)
|
|
<BR>
|
|
<INPUT TYPE=radio NAME=casefold VALUE=yes CHECKED>
|
|
Fold case
|
|
/
|
|
<INPUT TYPE=radio NAME=casefold VALUE=no>
|
|
Case sensitive
|
|
<BR>
|
|
<INPUT TYPE=hidden NAME=req VALUE=search>
|
|
</FORM>
|
|
|
|
</BLOCKQUOTE>
|
|
|
|
<HR>
|
|
|
|
<H2>Other forms of %(FAQNAME)s access:</H2>
|
|
|
|
<UL>
|
|
<LI><A HREF="%(FAQCGI)s?req=index">FAQ index</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=all">The whole FAQ</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=recent">What's new in the FAQ?</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=roulette">FAQ roulette</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=add">Add a FAQ entry</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=delete">Delete a FAQ entry</A>
|
|
</UL>
|
|
"""
|
|
|
|
# Index formatting
|
|
|
|
INDEX_SECTION = """
|
|
<P>
|
|
<HR>
|
|
<H2>%(sec)s. %(title)s</H2>
|
|
<UL>
|
|
"""
|
|
|
|
INDEX_ADDSECTION = """
|
|
<P>
|
|
<LI><A HREF="%(FAQCGI)s?req=new&section=%(sec)s">Add new entry</A>
|
|
(at this point)
|
|
"""
|
|
|
|
INDEX_ENDSECTION = """
|
|
</UL>
|
|
"""
|
|
|
|
INDEX_ENTRY = """\
|
|
<LI><A HREF="%(FAQCGI)s?req=show&file=%(file)s">%(title)s</A>
|
|
"""
|
|
|
|
LOCAL_ENTRY = """\
|
|
<LI><A HREF="#%(sec)s.%(num)s">%(title)s</A>
|
|
"""
|
|
|
|
# Entry formatting
|
|
|
|
ENTRY_HEADER1 = """
|
|
<HR>
|
|
<H2><A NAME="%(sec)s.%(num)s">%(title)s</A>\
|
|
"""
|
|
|
|
ENTRY_HEADER2 = """\
|
|
</H2>
|
|
"""
|
|
|
|
ENTRY_FOOTER = """
|
|
<A HREF="%(FAQCGI)s?req=edit&file=%(file)s">Edit this entry</A> /
|
|
<A HREF="%(FAQCGI)s?req=log&file=%(file)s">Log info</A>
|
|
"""
|
|
|
|
ENTRY_LOGINFO = """
|
|
/ Last changed on %(last_changed_date)s by
|
|
<A HREF="mailto:%(last_changed_email)s">%(last_changed_author)s</A>
|
|
"""
|
|
|
|
# Search
|
|
|
|
NO_HITS = """
|
|
No hits.
|
|
"""
|
|
|
|
ONE_HIT = """
|
|
Your search matched the following entry:
|
|
"""
|
|
|
|
FEW_HITS = """
|
|
Your search matched the following %(count)s entries:
|
|
"""
|
|
|
|
MANY_HITS = """
|
|
Your search matched more than %(MAXHITS)s entries.
|
|
The %(count)s matching entries are presented here ordered by section:
|
|
"""
|
|
|
|
# RCS log and diff
|
|
|
|
LOG = """
|
|
Click on a revision line to see the diff between that revision and the
|
|
previous one.
|
|
"""
|
|
|
|
REVISIONLINK = """\
|
|
<A HREF="%(FAQCGI)s?req=revision&file=%(file)s&rev=%(rev)s"
|
|
>%(line)s</A>\
|
|
"""
|
|
DIFFLINK = """\
|
|
(<A HREF="%(FAQCGI)s?req=diff&file=%(file)s&\
|
|
prev=%(prev)s&rev=%(rev)s"
|
|
>diff -r%(prev)s -r%(rev)s</A>)\
|
|
"""
|
|
|
|
# Recently changed entries
|
|
|
|
NO_RECENT = """
|
|
<HR>
|
|
No %(FAQNAME)s entries were changed in the last %(period)s.
|
|
"""
|
|
|
|
VIEW_MENU = """
|
|
<HR>
|
|
View entries changed in the last...
|
|
<UL>
|
|
<LI><A HREF="%(FAQCGI)s?req=recent&days=1">24 hours</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=recent&days=2">2 days</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=recent&days=3">3 days</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=recent&days=7">week</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=recent&days=28">4 weeks</A>
|
|
<LI><A HREF="%(FAQCGI)s?req=recent&days=365250">millennium</A>
|
|
</UL>
|
|
"""
|
|
|
|
ONE_RECENT = VIEW_MENU + """
|
|
The following %(FAQNAME)s entry was changed in the last %(period)s:
|
|
"""
|
|
|
|
SOME_RECENT = VIEW_MENU + """
|
|
The following %(count)s %(FAQNAME)s entries were changed
|
|
in the last %(period)s, most recently changed shown first:
|
|
"""
|
|
|
|
TAIL_RECENT = VIEW_MENU
|
|
|
|
# Last changed banner on "all" (strftime format)
|
|
LAST_CHANGED = "Last changed on %c %Z"
|
|
|
|
# "Compat" command prologue (this has no <BODY> tag)
|
|
COMPAT = """
|
|
<H1>The whole %(FAQNAME)s</H1>
|
|
See also the <A HREF="%(FAQCGI)s?req=home">%(FAQNAME)s Wizard</A>.
|
|
<P>
|
|
"""
|
|
|
|
# Editing
|
|
|
|
EDITHEAD = """
|
|
<A HREF="%(FAQCGI)s?req=help">Click for Help</A>
|
|
"""
|
|
|
|
REVIEWHEAD = EDITHEAD
|
|
|
|
|
|
EDITFORM1 = """
|
|
<FORM ACTION="%(FAQCGI)s" METHOD=POST>
|
|
<INPUT TYPE=hidden NAME=req VALUE=review>
|
|
<INPUT TYPE=hidden NAME=file VALUE=%(file)s>
|
|
<INPUT TYPE=hidden NAME=editversion VALUE=%(editversion)s>
|
|
<HR>
|
|
"""
|
|
|
|
EDITFORM2 = """
|
|
Title: <INPUT TYPE=text SIZE=70 NAME=title VALUE="%(title)s"><BR>
|
|
<TEXTAREA COLS=72 ROWS=20 NAME=body>%(body)s
|
|
</TEXTAREA><BR>
|
|
Log message (reason for the change):<BR>
|
|
<TEXTAREA COLS=72 ROWS=5 NAME=log>%(log)s
|
|
</TEXTAREA><BR>
|
|
Please provide the following information for logging purposes:
|
|
<TABLE FRAME=none COLS=2>
|
|
<TR>
|
|
<TD>Name:
|
|
<TD><INPUT TYPE=text SIZE=40 NAME=author VALUE="%(author)s">
|
|
<TR>
|
|
<TD>Email:
|
|
<TD><INPUT TYPE=text SIZE=40 NAME=email VALUE="%(email)s">
|
|
<TR>
|
|
<TD>Password:
|
|
<TD><INPUT TYPE=password SIZE=20 NAME=password VALUE="%(password)s">
|
|
</TABLE>
|
|
|
|
<INPUT TYPE=submit NAME=review VALUE="Preview Edit">
|
|
Click this button to preview your changes.
|
|
"""
|
|
|
|
EDITFORM3 = """
|
|
</FORM>
|
|
"""
|
|
|
|
COMMIT = """
|
|
<INPUT TYPE=submit NAME=commit VALUE="Commit">
|
|
Click this button to commit your changes.
|
|
<HR>
|
|
"""
|
|
|
|
NOCOMMIT_HEAD = """
|
|
To commit your changes, please correct the following errors in the
|
|
form below and click the Preview Edit button.
|
|
<UL>
|
|
"""
|
|
NOCOMMIT_TAIL = """
|
|
</UL>
|
|
<HR>
|
|
"""
|
|
|
|
CANTCOMMIT_HEAD = """
|
|
Some required information is missing:
|
|
<UL>
|
|
"""
|
|
NEED_PASSWD = "<LI>You must provide the correct password.\n"
|
|
NEED_AUTHOR = "<LI>You must enter your name.\n"
|
|
NEED_EMAIL = "<LI>You must enter your email address.\n"
|
|
NEED_LOG = "<LI>You must enter a log message.\n"
|
|
CANTCOMMIT_TAIL = """
|
|
</UL>
|
|
Please use your browser's Back command to correct the form and commit
|
|
again.
|
|
"""
|
|
|
|
NEWCONFLICT = """
|
|
<P>
|
|
You are creating a new entry, but the entry number specified is not
|
|
correct.
|
|
<P>
|
|
The two most common causes of this problem are:
|
|
<UL>
|
|
<LI>After creating the entry yourself, you went back in your browser,
|
|
edited the entry some more, and clicked Commit again.
|
|
<LI>Someone else started creating a new entry in the same section and
|
|
committed before you did.
|
|
</UL>
|
|
(It is also possible that the last entry in the section was physically
|
|
deleted, but this should not happen except through manual intervention
|
|
by the FAQ maintainer.)
|
|
<P>
|
|
<A HREF="%(FAQCGI)s?req=new&section=%(sec)s">Click here to try
|
|
again.</A>
|
|
<P>
|
|
"""
|
|
|
|
VERSIONCONFLICT = """
|
|
<P>
|
|
You edited version %(editversion)s but the current version is %(version)s.
|
|
<P>
|
|
The two most common causes of this problem are:
|
|
<UL>
|
|
<LI>After committing a change, you went back in your browser,
|
|
edited the entry some more, and clicked Commit again.
|
|
<LI>Someone else started editing the same entry and committed
|
|
before you did.
|
|
</UL>
|
|
<P>
|
|
<A HREF="%(FAQCGI)s?req=show&file=%(file)s">Click here to reload
|
|
the entry and try again.</A>
|
|
<P>
|
|
"""
|
|
|
|
CANTWRITE = """
|
|
Can't write file %(file)s (%(why)s).
|
|
"""
|
|
|
|
FILEHEADER = """\
|
|
Title: %(title)s
|
|
Last-Changed-Date: %(date)s
|
|
Last-Changed-Author: %(author)s
|
|
Last-Changed-Email: %(email)s
|
|
Last-Changed-Remote-Host: %(REMOTE_HOST)s
|
|
Last-Changed-Remote-Address: %(REMOTE_ADDR)s
|
|
"""
|
|
|
|
LOGHEADER = """\
|
|
Last-Changed-Date: %(date)s
|
|
Last-Changed-Author: %(author)s
|
|
Last-Changed-Email: %(email)s
|
|
Last-Changed-Remote-Host: %(REMOTE_HOST)s
|
|
Last-Changed-Remote-Address: %(REMOTE_ADDR)s
|
|
|
|
%(log)s
|
|
"""
|
|
|
|
COMMITTED = """
|
|
Your changes have been committed.
|
|
"""
|
|
|
|
COMMITFAILED = """
|
|
Exit status %(sts)s.
|
|
"""
|
|
|
|
# Add/Delete
|
|
|
|
ADD_HEAD = """
|
|
At the moment, new entries can only be added at the end of a section.
|
|
This is because the entry numbers are also their
|
|
unique identifiers -- it's a bad idea to renumber entries.
|
|
<P>
|
|
Click on the section to which you want to add a new entry:
|
|
<UL>
|
|
"""
|
|
|
|
ADD_SECTION = """\
|
|
<LI><A HREF="%(FAQCGI)s?req=new&section=%(section)s">%(section)s. %(title)s</A>
|
|
"""
|
|
|
|
ADD_TAIL = """
|
|
</UL>
|
|
"""
|
|
|
|
ROULETTE = """
|
|
<P>Hit your browser's Reload button to play again.<P>
|
|
"""
|
|
|
|
DELETE = """
|
|
At the moment, there's no direct way to delete entries.
|
|
This is because the entry numbers are also their
|
|
unique identifiers -- it's a bad idea to renumber entries.
|
|
<P>
|
|
If you really think an entry needs to be deleted,
|
|
change the title to "(deleted)" and make the body
|
|
empty (keep the entry number in the title though).
|
|
"""
|
|
|
|
# Help file for the FAQ Edit Wizard
|
|
|
|
HELP = """
|
|
Using the %(FAQNAME)s Edit Wizard speaks mostly for itself. Here are
|
|
some answers to questions you are likely to ask:
|
|
|
|
<P><HR>
|
|
|
|
<H2>I can review an entry but I can't commit it.</H2>
|
|
|
|
The commit button only appears if the following conditions are met:
|
|
|
|
<UL>
|
|
|
|
<LI>The Name field is not empty.
|
|
|
|
<LI>The Email field contains at least an @ character.
|
|
|
|
<LI>The Log message box is not empty.
|
|
|
|
<LI>The Password field contains the proper password.
|
|
|
|
</UL>
|
|
|
|
<P><HR>
|
|
|
|
<H2>What is the password?</H2>
|
|
|
|
At the moment, only PSA members will be told the password. This is a
|
|
good time to join the PSA! See <A
|
|
HREF="http://www.python.org/psa/">the PSA home page</A>.
|
|
|
|
<P><HR>
|
|
|
|
<H2>Can I use HTML in the FAQ entry?</H2>
|
|
|
|
Yes, if you include it in <HTML&rt; and </HTML> tags.
|
|
<P>
|
|
Also, if you include a URL or an email address in the text it will
|
|
automatigally become an anchor of the right type. Also, *word*
|
|
is made italic (but only for single alphabetic words).
|
|
|
|
<P><HR>
|
|
|
|
<H2>How do I delineate paragraphs?</H2>
|
|
|
|
Use blank lines to separate paragraphs.
|
|
|
|
<P><HR>
|
|
|
|
<H2>How do I enter example text?</H2>
|
|
|
|
Any line that begins with a space or tab is assumed to be part of
|
|
literal text. Blocks of literal text delineated by blank lines are
|
|
placed inside <PRE>...</PRE>.
|
|
"""
|
|
|
|
# Load local customizations again, in case they set some other variables
|
|
|
|
try:
|
|
from faqcust import *
|
|
except ImportError:
|
|
pass
|