上传文件至 'test/Django-2.1.15/docs'

This commit is contained in:
a 2022-05-12 16:48:44 +08:00
parent ce085d4754
commit 32a00a589c
5 changed files with 1189 additions and 0 deletions

View File

@ -0,0 +1,162 @@
# Makefile for Sphinx documentation
#
# You can set these variables from the command line.
PYTHON ?= python
SPHINXOPTS ?=
SPHINXBUILD ?= sphinx-build
PAPER ?=
BUILDDIR ?= _build
LANGUAGE ?=
# Convert something like "en_US" to "en", because Sphinx does not recognize
# underscores. Country codes should be passed using a dash, e.g. "pt-BR".
LANGUAGEOPT = $(firstword $(subst _, ,$(LANGUAGE)))
# Internal variables.
PAPEROPT_a4 = -D latex_paper_size=a4
PAPEROPT_letter = -D latex_paper_size=letter
ALLSPHINXOPTS = -n -d $(BUILDDIR)/doctrees -D language=$(LANGUAGEOPT) $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
# the i18n builder cannot share the environment and doctrees with the others
I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
.PHONY: help clean html htmlview dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
help:
@echo "Please use \`make <target>' where <target> is one of"
@echo " html to make standalone HTML files"
@echo " htmlview to open the index page built by the html target in your browser"
@echo " dirhtml to make HTML files named index.html in directories"
@echo " singlehtml to make a single large HTML file"
@echo " pickle to make pickle files"
@echo " json to make JSON files"
@echo " htmlhelp to make HTML files and a HTML help project"
@echo " qthelp to make HTML files and a qthelp project"
@echo " devhelp to make HTML files and a Devhelp project"
@echo " epub to make an epub"
@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
@echo " latexpdf to make LaTeX files and run them through pdflatex"
@echo " text to make text files"
@echo " man to make manual pages"
@echo " texinfo to make a Texinfo source file"
@echo " gettext to make PO message catalogs"
@echo " changes to make an overview of all changed/added/deprecated items"
@echo " linkcheck to check all external links for integrity"
@echo " doctest to run all doctests embedded in the documentation (if enabled)"
@echo " spelling to check for typos in documentation"
clean:
-rm -rf $(BUILDDIR)/*
html:
$(SPHINXBUILD) -b djangohtml $(ALLSPHINXOPTS) $(BUILDDIR)/html
@echo
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
htmlview: html
$(PYTHON) -c "import webbrowser; webbrowser.open('_build/html/index.html')"
dirhtml:
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
@echo
@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
singlehtml:
$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
@echo
@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
pickle:
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
@echo
@echo "Build finished; now you can process the pickle files."
json:
$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
@echo
@echo "Build finished; now you can process the JSON files."
htmlhelp:
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
@echo
@echo "Build finished; now you can run HTML Help Workshop with the" \
".hhp project file in $(BUILDDIR)/htmlhelp."
qthelp:
$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
@echo
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/django.qhcp"
@echo "To view the help file:"
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/django.qhc"
devhelp:
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
@echo
@echo "Build finished."
@echo "To view the help file:"
@echo "# mkdir -p $$HOME/.local/share/devhelp/django"
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/django"
@echo "# devhelp"
epub:
$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
@echo
@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
latex:
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
@echo
@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
@echo "Run \`make' in that directory to run these through (pdf)latex" \
"(use \`make latexpdf' here to do that automatically)."
latexpdf:
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
@echo "Running LaTeX files through pdflatex..."
make -C $(BUILDDIR)/latex all-pdf
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
text:
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
@echo
@echo "Build finished. The text files are in $(BUILDDIR)/text."
man:
$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
@echo
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
texinfo:
$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
@echo
@echo "Build finished; the Texinfo files are in $(BUILDDIR)/texinfo."
gettext:
$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
@echo
@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
changes:
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
@echo
@echo "The overview file is in $(BUILDDIR)/changes."
linkcheck:
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
@echo
@echo "Link check complete; look for any errors in the above output " \
"or in $(BUILDDIR)/linkcheck/output.txt."
doctest:
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
@echo "Testing of doctests in the sources finished, look at the " \
"results in $(BUILDDIR)/doctest/output.txt."
spelling:
$(SPHINXBUILD) -b spelling $(ALLSPHINXOPTS) $(BUILDDIR)/spelling
@echo
@echo "Check finished. Wrong words can be found in " \
"$(BUILDDIR)/spelling/output.txt."

View File

@ -0,0 +1,17 @@
The documentation in this tree is in plain text files and can be viewed using
any text file viewer.
It uses ReST (reStructuredText) [1], and the Sphinx documentation system [2].
This allows it to be built into other forms for easier viewing and browsing.
To create an HTML version of the docs:
* Install Sphinx (using ``pip install Sphinx`` or some other method)
* In this docs/ directory, type ``make html`` (or ``make.bat html`` on
Windows) at a shell prompt.
The documentation in _build/html/index.html can then be viewed in a web browser.
[1] http://docutils.sourceforge.net/rst.html
[2] http://sphinx-doc.org/

View File

@ -0,0 +1,28 @@
=============================
Django documentation contents
=============================
.. toctree::
:hidden:
index
.. toctree::
:maxdepth: 3
intro/index
topics/index
howto/index
faq/index
ref/index
misc/index
glossary
releases/index
internals/index
Indices, glossary and tables
============================
* :ref:`genindex`
* :ref:`modindex`
* :doc:`glossary`

View File

@ -0,0 +1,189 @@
@ECHO OFF
REM Command file for Sphinx documentation
if "%SPHINXBUILD%" == "" (
set SPHINXBUILD=sphinx-build
)
set BUILDDIR=_build
set ALLSPHINXOPTS=-n -d %BUILDDIR%/doctrees %SPHINXOPTS% .
if NOT "%PAPER%" == "" (
set ALLSPHINXOPTS=-D latex_paper_size=%PAPER% %ALLSPHINXOPTS%
set I18NSPHINXOPTS=-D latex_paper_size=%PAPER% %I18NSPHINXOPTS%
)
if "%1" == "" goto help
if "%1" == "help" (
:help
echo.Please use `make ^<target^>` where ^<target^> is one of
echo. html to make standalone HTML files
echo. dirhtml to make HTML files named index.html in directories
echo. singlehtml to make a single large HTML file
echo. pickle to make pickle files
echo. json to make JSON files
echo. htmlhelp to make HTML files and a HTML help project
echo. qthelp to make HTML files and a qthelp project
echo. devhelp to make HTML files and a Devhelp project
echo. epub to make an epub
echo. latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter
echo. text to make text files
echo. man to make manual pages
echo. texinfo to make a Texinfo source file
echo. gettext to make PO message catalogs
echo. changes to make an overview over all changed/added/deprecated items
echo. linkcheck to check all external links for integrity
echo. doctest to run all doctests embedded in the documentation if enabled
goto end
)
if "%1" == "clean" (
for /d %%i in (%BUILDDIR%\*) do rmdir /q /s %%i
del /q /s %BUILDDIR%\*
goto end
)
if "%1" == "html" (
%SPHINXBUILD% -b djangohtml %ALLSPHINXOPTS% %BUILDDIR%/html
if errorlevel 1 exit /b 1
echo.
echo.Build finished. The HTML pages are in %BUILDDIR%/html.
goto end
)
if "%1" == "dirhtml" (
%SPHINXBUILD% -b dirhtml %ALLSPHINXOPTS% %BUILDDIR%/dirhtml
if errorlevel 1 exit /b 1
echo.
echo.Build finished. The HTML pages are in %BUILDDIR%/dirhtml.
goto end
)
if "%1" == "singlehtml" (
%SPHINXBUILD% -b singlehtml %ALLSPHINXOPTS% %BUILDDIR%/singlehtml
if errorlevel 1 exit /b 1
echo.
echo.Build finished. The HTML pages are in %BUILDDIR%/singlehtml.
goto end
)
if "%1" == "pickle" (
%SPHINXBUILD% -b pickle %ALLSPHINXOPTS% %BUILDDIR%/pickle
if errorlevel 1 exit /b 1
echo.
echo.Build finished; now you can process the pickle files.
goto end
)
if "%1" == "json" (
%SPHINXBUILD% -b json %ALLSPHINXOPTS% %BUILDDIR%/json
if errorlevel 1 exit /b 1
echo.
echo.Build finished; now you can process the JSON files.
goto end
)
if "%1" == "htmlhelp" (
%SPHINXBUILD% -b htmlhelp %ALLSPHINXOPTS% %BUILDDIR%/htmlhelp
if errorlevel 1 exit /b 1
echo.
echo.Build finished; now you can run HTML Help Workshop with the ^
.hhp project file in %BUILDDIR%/htmlhelp.
goto end
)
if "%1" == "qthelp" (
%SPHINXBUILD% -b qthelp %ALLSPHINXOPTS% %BUILDDIR%/qthelp
if errorlevel 1 exit /b 1
echo.
echo.Build finished; now you can run "qcollectiongenerator" with the ^
.qhcp project file in %BUILDDIR%/qthelp, like this:
echo.^> qcollectiongenerator %BUILDDIR%\qthelp\django.qhcp
echo.To view the help file:
echo.^> assistant -collectionFile %BUILDDIR%\qthelp\django.qhc
goto end
)
if "%1" == "devhelp" (
%SPHINXBUILD% -b devhelp %ALLSPHINXOPTS% %BUILDDIR%/devhelp
if errorlevel 1 exit /b 1
echo.
echo.Build finished.
goto end
)
if "%1" == "epub" (
%SPHINXBUILD% -b epub %ALLSPHINXOPTS% %BUILDDIR%/epub
if errorlevel 1 exit /b 1
echo.
echo.Build finished. The epub file is in %BUILDDIR%/epub.
goto end
)
if "%1" == "latex" (
%SPHINXBUILD% -b latex %ALLSPHINXOPTS% %BUILDDIR%/latex
if errorlevel 1 exit /b 1
echo.
echo.Build finished; the LaTeX files are in %BUILDDIR%/latex.
goto end
)
if "%1" == "text" (
%SPHINXBUILD% -b text %ALLSPHINXOPTS% %BUILDDIR%/text
if errorlevel 1 exit /b 1
echo.
echo.Build finished. The text files are in %BUILDDIR%/text.
goto end
)
if "%1" == "man" (
%SPHINXBUILD% -b man %ALLSPHINXOPTS% %BUILDDIR%/man
if errorlevel 1 exit /b 1
echo.
echo.Build finished. The manual pages are in %BUILDDIR%/man.
goto end
)
if "%1" == "texinfo" (
%SPHINXBUILD% -b texinfo %ALLSPHINXOPTS% %BUILDDIR%/texinfo
if errorlevel 1 exit /b 1
echo.
echo.Build finished. The Texinfo files are in %BUILDDIR%/texinfo.
goto end
)
if "%%1" == "gettext" (
%SPHINXBUILD% -b gettext %I18NSPHINXOPTS% %BUILDDIR%/locale
if errorlevel 1 exit /b 1
echo.
echo.Build finished. The message catalogs are in %BUILDDIR%/locale.
goto end
)
if "%1" == "changes" (
%SPHINXBUILD% -b changes %ALLSPHINXOPTS% %BUILDDIR%/changes
if errorlevel 1 exit /b 1
echo.
echo.The overview file is in %BUILDDIR%/changes.
goto end
)
if "%1" == "linkcheck" (
%SPHINXBUILD% -b linkcheck %ALLSPHINXOPTS% %BUILDDIR%/linkcheck
if errorlevel 1 exit /b 1
echo.
echo.Link check complete; look for any errors in the above output ^
or in %BUILDDIR%/linkcheck/output.txt.
goto end
)
if "%1" == "doctest" (
%SPHINXBUILD% -b doctest %ALLSPHINXOPTS% %BUILDDIR%/doctest
if errorlevel 1 exit /b 1
echo.
echo.Testing of doctests in the sources finished, look at the ^
results in %BUILDDIR%/doctest/output.txt.
goto end
)
:end

View File

@ -0,0 +1,793 @@
à
accessor
accessors
Aceh
admin
admindocs
admins
affine
aggregator
Ai
Alchin
alphanumerics
amet
amongst
analytics
apnumber
app
appname
apps
architected
arg
args
assistive
atomicity
attr
auth
autoclobber
autocommit
autocomplete
autocompletion
autodetect
autodetectable
autodetection
autodetector
autodiscovery
autoescape
autoescaping
autoextend
autogenerated
autoincrement
autoreload
Azerbaijani
backend
backends
backport
backported
backports
backtraces
balancer
basename
Bcc
BCC'ed
bcrypt
beatles
Beaven
benchmarking
Benoit
Berners
Biggs
bitwise
Bjørn
blazingly
blog
blogs
boilerplatish
Bokmål
bolded
Bonham
bookmarklet
bookmarklets
boolean
booleans
bpython
Bronn
bugfix
bugfixes
buildbot
builtin
builtins
bulleted
Byteorder
bytestring
bytestrings
cacheable
callables
camelCase
cardinality
centric
centroid
changelist
changeset
charset
checkbox
checkboxes
checkin
checksum
checksums
clearable
clickable
clickjacking
cms
codebase
codec
codename
codenamed
coercible
commenters
committer
committers
concat
conf
config
contenttypes
contrib
covariance
criticals
cron
crontab
cryptographic
cryptographically
csrf
csrfmiddlewaretoken
css
csv
ctime
Ctrl
customizability
customizable
customizations
Dahl
Daly
Danga
Darussalam
databrowse
datafile
dataset
datasets
datatype
datetimes
Debian
declaratively
deconstruct
deconstructing
decrement
decrementing
deduplicates
deepcopy
deferrable
deprecations
deserialization
deserialize
deserialized
deserializer
deserializing
deterministically
Deutsch
dev
dict
dictConfig
dicts
diff
Dimensionally
dimensioned
dirmod
discoverable
Disqus
distro
Django
djangoproject
Django's
dm
docstring
docstrings
doctests
doctype
documentational
DoS
downloadable
Dreamweaver
drilldown
dropdown
dropdowns
drupal
Dunck
editability
elidable
encodings
Endian
Enero
environ
esque
Ess
ETag
ETags
exe
extensibility
Facebook
fallback
fallbacks
faq
FastCGI
favicon
fieldset
fieldsets
filename
filenames
filesystem
filesystems
Firesheep
fk
flatpage
flatpages
Flatpages
followup
fooapp
formatters
formfield
formset
formsets
formtools
freenode
Frysian
functionalities
gdal
geo
Geoff
geoip
geolibs
geolocalized
geolocated
geolocation
geoquerysets
georeference
georeferenced
georeferencing
geospatial
Gettext
GiB
gid
gis
GitHub
globalization
google
Googol
Greenhill
grey
gte
gunicorn
gz
GZip
gzipped
hackish
handheld
hardcode
hardcoded
hardcoding
hashable
hasher
hashers
headerlist
hoc
Hoerner
Holovaty
Holscher
Homebrew
hostname
hostnames
hstore
html
http
https
hyperlinks
ie
ies
iframe
inbox
incrementing
indexable
indices
ing
ini
init
inline
inlines
Instagram
instantiation
interdependencies
internet
interoperability
intranet
ip
ipsum
IPv
IPython
irc
ise
iso
iterable
iterables
iteratively
iTunes
ize
JavaScript
Jinja
jQuery
jython
Kaplan
Kessler
keyservers
KiB
kilometre
Koziarski
kwarg
kwargs
Kyngesburye
latin
lawrence
lexer
lifecycle
lifecycles
linearize
linestring
linework
linter
Livni
localflavor
localhost
localizable
localizers
localtime
login
logout
lookaround
lookup
lookups
loopback
lorem
lossy
lowercased
lowercasing
lt
lte
Luhn
macOS
Magee
Mako
manouche
Marczewski
Marino
MBR
memcache
memcached
mentorship
metaclass
metaclasses
metadata
metre
MiB
micrometre
middleware
migrationname
millimetre
Minification
minified
minify
mis
misconfiguration
mitre
mixin
mixins
modelforms
modelformset
modwsgi
monkeypatched
mssql
multi
Multi
multicolumn
multijoins
multiline
multilinestring
multipart
multipolygon
multitenancy
multithreaded
multithreading
multivalued
Mumbai
myapp
myproject
mysite
mysql
mysqlclient
naïve
namespace
namespaced
namespaces
namespacing
Nanggroe
natively
nd
needsinfo
německy
newforms
nginx
noding
nonnegative
nonspatial
nullable
OAuth
offline
OGC
OGR
oldforms
online
ons
onwards
optimizations
orderable
org
Orléans
orm
outbox
Outdim
outfile
paginator
parallelization
parallelized
parameterization
parameterized
params
parens
parsers
Paweł
pdf
PEM
perl
permalink
pessimization
Peucker
pgAdmin
PGRaster
phishing
php
picklable
picosecond
PIL
pingback
pingbacks
Pinney
Pinterest
plaintext
pluggable
plugin
plugins
pluralizations
po
podcast
pooler
pooling
popup
postfix
postgis
postgres
postgresql
pq
pre
precisions
precomputation
preconfigured
prefetch
prefetched
prefetches
prefetching
preload
prepend
prepended
prepending
prepends
prepopulate
prepopulated
prepopulates
preprocess
preprocessed
preprocesses
preprocessing
programmatically
proxied
proxying
pseudocode
psycopg
Punycode
Puthraya
py
pyformat
pysqlite
pythonic
pytz
qs
queryset
querysets
querystring
queueing
Quickstart
QUnit
quo
quoteless
Radziej
raster
rasters
rc
readded
reallow
reallowed
reallows
rebase
rebased
rebasing
recomputation
recursed
redeclare
redirections
redisplay
redisplayed
redisplaying
redisplays
refactor
refactored
refactoring
refactorings
refactors
referer
referers
reflow
regex
registrable
reimplement
reindent
reindex
reinstall
releaser
releasers
reloader
renderer
renderers
repo
reportable
reprojection
reraising
resampling
reST
reStructuredText
reusability
revalidate
reverter
roadmap
Roald
rss
runtime
Sandvik
savepoint
savepoints
scalable
Schaub
schemas
screencast
screencasts
screenshot
screenshots
semimajor
semiminor
serializability
serializable
serializer
serializers
sessionid
setuptools
sha
shapefile
shapefiles
sharding
sid
simultaneously
sitemap
sitemaps
sitewide
slashdot
sliceable
slippy
SMTP
solaris
Solr
sortable
spam
spammers
spatialite
Springmeyer
SQL
ssi
SSL
stacktrace
startup
stateful
staticfile
staticfiles
stderr
stdlib
stdout
storages
stylesheet
stylesheets
subclass
subclassed
subclasses
subclassing
subcommand
subcommands
subdir
subdirectories
subdirectory
subdomain
subdomains
subfields
sublanguage
sublist
submodule
submodules
subpath
subprocesses
subqueries
subquery
subselect
substring
subtemplate
subtemplates
subtransactions
subtree
subtype
subviews
subwidget
subwidgets
superclass
superclasses
superset
swappable
symlink
symlinking
symlinks
syntaxes
sysadmin
systemwide
tablespace
tablespaces
tagline
tarball
tarballs
teardown
templating
testcase
textarea
th
that'll
Thejaswi
This'll
timeframe
timeline
timelines
timesaving
timestamp
timestamped
timestamps
timezones
titlecase
tmp
tokenized
toolbar
toolkits
toolset
Tox
trac
tracebacks
transactional
Transifex
Tredinnick
triager
triagers
triaging
trigram
trigrams
tuple
tuples
tv
txt
tz
ubuntu
ul
umask
Unaccent
unannotated
unapplied
unapply
unapplying
uncategorized
uncheck
unclaim
uncopyable
unencoded
unencrypted
unescape
unescaped
unevaluated
unglamorous
ungrouped
unhandled
unharmful
unhashable
unicode
uninstall
uninstalling
unioning
uniterated
unlocalize
unlocalized
unmaintained
unmanaged
unordered
unparseable
unparsed
unpickle
unpickled
unpickling
unpopulated
unpythonic
unrendered
unreproducible
Unreviewed
unsanitized
unselected
unsets
unsquashed
untar
untrusted
unvalidated
uppercased
url
urljoins
urlpatterns
urls
username
usernames
utc
UTF
util
utils
uwsgi
uWSGI
validator
validators
validsite
VARCHAR
variadic
vendored
vendorname
versa
versioned
versioning
vertices
viewable
virtualenv
virtualenvs
virtualized
Weblog
whitelist
whitelisted
whitespace
whitespaces
whizbang
wiki
wikipedia
wildcard
wildcards
Willison
wontfix
workflow
worksforme
wrappable
wsgi
www
xe
xgettext
XSS
xxxxx
Zope