django-admin - Online in de Cloud

PROGRAMMA:

NAAM

django-admin - Utility script voor het Django Web framework

django-admin is het opdrachtregelprogramma van Django voor administratieve taken. Dit document
schetst alles wat het kan doen.

Vóór Django 1.7, django-admin werd alleen geïnstalleerd als django-admin.py.

Daarnaast, manage.py wordt automatisch aangemaakt in elk Django-project. manage.py is een
dun omhulsel eromheen django-admin die eerder een aantal dingen voor u regelt
delegeren naar django-admin:

· Het zet het pakket van uw project aan sys.pad.

· Het stelt de DJANGO_SETTINGS_MODULE omgevingsvariabele zodat deze naar uw verwijst
project settings.py bestand.

· Het roept django.setup() om verschillende internals van Django te initialiseren.

django.setup() bestond niet in eerdere versies van Django.

De django-admin script zou op uw systeempad moeten staan ​​als u Django via its
setup.py nutsvoorziening. Als het niet op jouw pad ligt, kun je het erin vinden site-pakketten/django/bin
binnen uw Python-installatie. Overweeg om het ergens op uw pad symbolisch te koppelen, bijvoorbeeld
as / Usr / local / bin.

Voor Windows-gebruikers die niet over de functionaliteit voor symlinking beschikken, kunt u kopiëren
django-admin.exe naar een locatie op uw bestaande pad of bewerk het PATH instellingen (onder
Instellingen - Controle Paneel - Systeem - Geavanceerd - Omgeving...) om naar het geïnstalleerde bestand te verwijzen
plaats.

Over het algemeen is het gemakkelijker te gebruiken als u aan één Django-project werkt manage.py neem contact
django-admin. Als u moet schakelen tussen meerdere Django-instellingenbestanden, gebruikt u
django-admin Met DJANGO_SETTINGS_MODULE of de --instellingen opdrachtregeloptie.

In de opdrachtregelvoorbeelden in dit document wordt gebruik gemaakt van django-admin consequent zijn, maar
elk voorbeeld kan gebruiken manage.py net zo goed.

GEBRUIK

$ django-admin [opties]
$ beheren.py [opties]

commando zou een van de commando's moeten zijn die in dit document worden vermeld. optiesDit is
optioneel, moet nul of meer opties zijn die beschikbaar zijn voor de gegeven opdracht.

Krijgen runtime hulp
django-admin hulp

lopen django-admin hulp om gebruiksinformatie weer te geven en een lijst met de opdrachten van
elke toepassing.

lopen django-admin hulp --commando's om een ​​lijst met alle beschikbare opdrachten weer te geven.

lopen django-admin hulp om een ​​beschrijving van het gegeven commando en een lijst weer te geven
van de beschikbare opties.

app namen
Veel opdrachten gebruiken een lijst met 'app-namen'. Een "app-naam" is de basisnaam van het pakket
met uw modellen. Als uw GEÏNSTALLEERDE_APPS bevat de string
'mijnsite.blog', de app-naam is blog.

Het bepalen de versie
django-admin versie

lopen django-admin versie om de huidige Django-versie weer te geven.

De uitvoer volgt het schema dat wordt beschreven in PEP 386:

1.4.dev17026
1.4a1
1.4

Display debug uitgang
Te gebruiken --breedsprakigheid om de hoeveelheid meldings- en foutopsporingsinformatie op te geven
django-admin moet naar de console worden afgedrukt. Voor meer details, zie de documentatie voor de
--breedsprakigheid optie.

BESCHIKBAAR COMMANDO'S

controle <appname applicatie naam ...>
django-admin controle

Gebruikt de system controle kader om het hele Django-project te inspecteren op veelvoorkomende problemen.

Het systeemcontroleframework zal bevestigen dat er geen problemen zijn met uw geïnstalleerde programma
modellen of uw beheerdersregistraties. Het zal ook waarschuwingen geven over algemene compatibiliteit
problemen die zijn geïntroduceerd door het upgraden van Django naar een nieuwe versie. Er kunnen aangepaste controles worden ingevoerd
door andere bibliotheken en applicaties.

Standaard worden alle apps aangevinkt. U kunt een subset van apps controleren door een lijst op te geven
van app-labels als argumenten:

python manage.py controleer auth admin myapp

Als u geen app opgeeft, worden alle apps gecontroleerd.

--label

De system controle kader voert veel verschillende soorten controles uit. Deze soorten cheques zijn
gecategoriseerd met tags. Met deze tags kunt u de uitgevoerde controles beperken tot alleen
die in een bepaalde categorie. Om bijvoorbeeld alleen beveiliging en compatibiliteit uit te voeren
controles, voert u het volgende uit:

python manage.py check --tag beveiliging --tag compatibiliteit

--lijst-tags

Maak een lijst van alle beschikbare tags.

--aanwenden

De --aanwenden optie activeert enkele extra controles die alleen relevant zijn in a
implementatie instelling.

U kunt deze optie gebruiken in uw lokale ontwikkelomgeving, maar aangezien uw local
De module voor ontwikkelingsinstellingen heeft mogelijk niet veel van uw productie-instellingen, maar dat zult u wel doen
waarschijnlijk wil wijzen controle commando in een andere instellingenmodule, hetzij door setting
de DJANGO_SETTINGS_MODULE omgevingsvariabele, of door de --instellingen optie:

python manage.py check --deploy --settings=production_settings

Of u kunt het rechtstreeks uitvoeren op een productie- of staging-implementatie om te verifiëren dat de
correcte instellingen worden gebruikt (weglaten --instellingen). Je zou het zelfs een onderdeel van je kunnen maken
integratie testpakket.

berichten compileren
django-admin berichten compileren

Compileert .po-bestanden gemaakt door berichten maken naar .mo-bestanden voor gebruik met de ingebouwde gettext
steun. Zien /topics/i18n/index.

Gebruik de --lokale optie (of de kortere versie ervan -l) om de landinstellingen op te geven die moeten worden verwerkt.
Indien niet opgegeven, worden alle landinstellingen verwerkt.

Gebruik de --uitsluiten optie (of de kortere versie ervan -x) om de landinstellingen op te geven die u wilt uitsluiten
uit verwerking. Indien niet opgegeven, worden geen landinstellingen uitgesloten.

Je kunt passeren --gebruik-fuzzy optie (of -f) om vage vertalingen op te nemen in gecompileerde bestanden.

Toegevoegd --uitsluiten en --gebruik-fuzzy opties.

Voorbeeld gebruik:

django-admin compileerberichten --locale=pt_BR
django-admin compileerberichten --locale=pt_BR --locale=fr -f
django-admin compilemessages -l pt_BR
django-admin compilemessages -l pt_BR -l fr --use-fuzzy
django-admin compilemessages --exclude=pt_BR
django-admin compilemessages --exclude=pt_BR --exclude=fr
django-admin compilemessages -x pt_BR
django-admin compileerberichten -x pt_BR -x fr

maakcachetabel
django-admin maakcachetabel

Creëert de cachetabellen voor gebruik met de databasecache-backend. Zien /onderwerpen/cache For
meer informatie.

De --databank optie kan worden gebruikt om de database te specificeren waarop de cachetabel zal worden geplaatst
worden geïnstalleerd.

Het is niet langer nodig om de naam van de cachetabel of de --databank keuze. Django
haalt deze informatie uit uw instellingenbestand. Als u meerdere caches of
meerdere databases, alle cachetabellen worden gemaakt.

dbshell
django-admin dbshell

Voert de opdrachtregelclient uit voor de database-engine die is opgegeven in uw MOTOR setting,
met de verbindingsparameters die zijn opgegeven in uw GEBRUIKER, WACHTWOORD, enz., instellingen.

· Voor PostgreSQL wordt hiermee de psql opdrachtregelclient.

· Voor MySQL draait dit de mysql opdrachtregelclient.

· Voor SQLite wordt hiermee de sqlite3 opdrachtregelclient.

Bij deze opdracht wordt ervan uitgegaan dat de programma's op uw computer staan PATH zodat een eenvoudige oproep naar het programma
naam (psql, mysql, sqlite3) vindt het programma op de juiste plaats. Er is geen manier om dat te doen
geef de locatie van het programma handmatig op.

De --databank optie kan worden gebruikt om de database te specificeren waarop een shell moet worden geopend.

verschillende instellingen
django-admin verschillende instellingen

Geeft verschillen weer tussen het huidige instellingenbestand en de standaardinstellingen van Django.

Instellingen die niet in de standaardinstellingen voorkomen, worden gevolgd door "###". De standaardinstelling bijvoorbeeld
instellingen definiëren niet ROOT_URLCONF, dus ROOT_URLCONF wordt gevolgd door "###" in de uitvoer van
verschillende instellingen.

De --alle Er kan een optie worden geboden om alle instellingen weer te geven, zelfs als ze Django's hebben
standaardwaarde. Dergelijke instellingen worden voorafgegaan door "###".

dumpgegevens <app_label app_label app_label.Model ...>
django-admin dumpgegevens

Voert uit naar standaarduitvoer alle gegevens in de database die zijn gekoppeld aan de genoemde
toepassing(en).

Als er geen applicatienaam wordt opgegeven, worden alle geïnstalleerde applicaties gedumpt.

De uitvoer van dumpgegevens kan gebruikt worden als input voor laadgegevens.

Merk op dat dumpgegevens gebruikt de standaardmanager op het model voor het selecteren van de records
dumpen. Als u een gewoonte manager als de standaardmanager en filtert een aantal van de
beschikbare records, worden niet alle objecten gedumpt.

De --alle Er kan een optie worden geboden om dat te specificeren dumpgegevens zou de basis van Django moeten gebruiken
manager, waarbij records worden gedumpt die anders door een aangepaste gebruiker zouden kunnen worden gefilterd of gewijzigd
manager.

--formaat

Standaard dumpgegevens formatteert de uitvoer in JSON, maar u kunt de --formaat optie
om een ​​ander formaat op te geven. Momenteel ondersteunde formaten worden vermeld in
serialisatie-formaten.

--inspringen

Standaard dumpgegevens zal alle gegevens op één regel weergeven. Dit is niet gemakkelijk voor mensen
lezen, zodat u de --inspringen optie om de uitvoer mooi af te drukken met een aantal
inkepingsruimten.

De --uitsluiten Er kan een optie worden geboden om specifieke toepassingen of modellen (gespecificeerd
zoals in de vorm van app_label.Modelnaam) tegen dumpen. Als u een modelnaam opgeeft voor
dumpgegevenszal de gedumpte output beperkt blijven tot dat model, en niet tot het geheel
sollicitatie. U kunt ook applicatienamen en modelnamen combineren.

De --databank optie kan worden gebruikt om de database op te geven waaruit gegevens zullen worden gedumpt.

--natuurlijk-buitenlands

Wanneer deze optie is opgegeven, gebruikt Django de natuurlijke_sleutel() modelmethode om te serialiseren
elke externe sleutel en veel-op-veel-relatie met objecten van het type dat de definieert
methode. Als je aan het dumpen bent bijdrage.auth Toestemming objecten of contrib.contenttypes
ContentType objecten, zou u waarschijnlijk deze vlag moeten gebruiken. Zie de natuurlijk toetsen
documentatie voor meer details over deze en de volgende optie.

--natuurlijk-primair

Wanneer deze optie is opgegeven, levert Django niet de primaire sleutel in het geserialiseerde bestand
gegevens van dit object, omdat deze kunnen worden berekend tijdens deserialisatie.

--natuurlijk

Verouderd sinds versie 1.7: gelijkwaardig aan de --natuurlijk-buitenlands keuze; gebruik dat
gebruiken.

Te gebruiken natuurlijk toetsen om elke externe sleutel en veel-op-veel-relatie met een model weer te geven
dat een natuurlijke sleuteldefinitie oplevert.

--pk

Standaard dumpgegevens zal alle records van het model uitvoeren, maar u kunt de --pk
optie om een ​​door komma's gescheiden lijst met primaire sleutels op te geven waarop moet worden gefilterd. Dit is alleen
beschikbaar bij het dumpen van één model.

--uitvoer

Standaard dumpgegevens zal alle geserialiseerde gegevens naar de standaarduitvoer uitvoeren. Deze opties
maakt het mogelijk om het bestand te specificeren waarnaar de gegevens moeten worden geschreven.

doorspoelen
django-admin doorspoelen

Verwijdert alle gegevens uit de database, voert eventuele post-synchronisatiehandlers opnieuw uit, en
installeert alle initiële dataarmaturen opnieuw.

De --geen input Er kan een optie worden geboden om alle gebruikersprompts te onderdrukken.

De --databank optie kan worden gebruikt om de database op te geven die moet worden leeggemaakt.

--geen initiële gegevens
Te gebruiken --geen initiële gegevens om te voorkomen dat de initial_data-fixatie wordt geladen.

geïnspecteerdb
django-admin geïnspecteerdb

Introspecteert de databasetabellen en -weergaven in de database waarnaar wordt verwezen door de NAAM het instellen van
en voert een Django-modelmodule uit (a modellen.py bestand) naar standaarduitvoer.

Gebruik dit als u een oudere database heeft waarmee u Django wilt gebruiken. Het script
inspecteert de database en maakt voor elke tabel of weergave daarin een model.

Zoals je zou verwachten, zullen de gemaakte modellen een attribuut hebben voor elk veld in de
tafel of uitzicht. Let daar op geïnspecteerdb heeft een paar speciale gevallen in de veldnaamuitvoer:

· Indien geïnspecteerdb kan het type van een kolom niet toewijzen aan een modelveldtype, het zal gebruiken Tekstveld en
zal het Python-commentaar invoegen 'Dit veld- type dan: is a gok.' naast het veld in de
gegenereerd model.

· Als de naam van de databasekolom een ​​gereserveerd Python-woord is (zoals 'doorgang', 'klasse' or
'voor'), geïnspecteerdb zal toevoegen '_veld' aan de attribuutnaam. Bijvoorbeeld als een tafel
heeft een kolom 'voor', zal het gegenereerde model een veld hebben 'voor_veld'Met
db_kolom attribuut ingesteld op 'voor'. geïnspecteerdb zal het Python-commentaar invoegen 'Veld
hernoemd omdat it was a Python gereserveerd woord.' naast het veld.

Deze functie is bedoeld als een snelkoppeling, niet als definitieve modelgeneratie. Nadat u het hebt uitgevoerd,
u wilt zelf de gegenereerde modellen bekijken om aanpassingen aan te brengen. In
In het bijzonder moet u de volgorde van de modellen herschikken, zodat modellen die naar andere verwijzen
modellen zijn correct besteld.

Primaire sleutels worden automatisch geïntrospecteerd voor PostgreSQL, MySQL en SQLite, waarin
geval Django erin stopt primaire_sleutel=Waar waar nodig.

geïnspecteerdb werkt met PostgreSQL, MySQL en SQLite. Detectie van buitenlandse sleutels werkt alleen in
PostgreSQL en met bepaalde soorten MySQL-tabellen.

Django maakt geen databasestandaardwaarden wanneer a verzuim wordt gespecificeerd in een modelveld.
Op dezelfde manier worden de standaardwaarden van de database niet vertaald naar de standaardwaarden van modelvelden, of in welke dan ook gedetecteerd
mode door geïnspecteerdb.

Standaard geïnspecteerdb creëert onbeheerde modellen. Dat is, beheerd = Niet waar in de modellen
meta class vertelt Django dat hij het maken, wijzigen en verwijderen van elke tabel niet moet beheren.
Als u Django de levenscyclus van de tabel wilt laten beheren, moet u de
beheerd optie om Waar (of verwijder het gewoon omdat Waar is de standaardwaarde).

De --databank optie kan worden gebruikt om de database te specificeren die u wilt introspecteren.

Er is een functie toegevoegd om databaseweergaven te inspecteren. In eerdere versies waren alleen tabellen (niet
bekeken) werden geïnspecteerd.

laadgegevens <fixture competitieprogramma ...>
django-admin laadgegevens

Zoekt naar en laadt de inhoud van de genoemde fixture in de database.

De --databank optie kan worden gebruikt om de database te specificeren waarin de gegevens zullen worden opgeslagen
geladen.

--niet bestaand

De --niet bestaand optie kan worden gebruikt om velden en modellen te negeren die mogelijk aanwezig zijn geweest
verwijderd sinds het armatuur oorspronkelijk werd gegenereerd.

--app

De --app optie kan worden gebruikt om een ​​enkele app te specificeren waarin naar armaturen moet worden gezocht in plaats van
door alle apps bladeren.

--app was toegevoegd.

--niet bestaand negeert ook niet-bestaande modellen.

Wat is a competitieprogramma ?
A competitieprogramma is een verzameling bestanden die de geserialiseerde inhoud van de database bevatten.
Elk armatuur heeft een unieke naam en de bestanden waaruit het armatuur bestaat, kunnen worden gedistribueerd
over meerdere mappen, in meerdere applicaties.

Django zoekt op drie locaties naar armaturen:

1. In de armaturen directory van elke geïnstalleerde applicatie

2. In elke map met de naam FIXTURE_DIRS het instellen van

3. In het letterlijke pad dat door het armatuur wordt genoemd

Django laadt alle armaturen die het op deze locaties vindt en die overeenkomen met de opgegeven locaties
namen van armatuur.

Als het benoemde apparaat een bestandsextensie heeft, zullen alleen apparaten van dat type worden geladen. Voor
voorbeeld:

django-admin loaddata mydata.json

zou alleen aangeroepen JSON-armaturen laden mijn data. De armatuurverlenging moet overeenkomen met de
geregistreerde naam van een serialisator (Bv json or xml).

Als u de extensies weglaat, zoekt Django in alle beschikbare armatuurtypes naar een match
armatuur. Bijvoorbeeld:

django-admin loaddata mijndata

zou zoeken naar elk armatuur van welk armatuurtype dan ook mijn data. Als het een armatuurmap is
bevatte mijndata.json, zou dat armatuur worden geladen als een JSON-armatuur.

De apparaten die een naam krijgen, kunnen directorycomponenten bevatten. Deze mappen zullen zijn
opgenomen in het zoekpad. Bijvoorbeeld:

django-admin loaddata foo/bar/mydata.json

zou zoeken /fixtures/foo/bar/mydata.json voor elke geïnstalleerde applicatie,
/foo/bar/mydata.json voor elke map in FIXTURE_DIRS, en het letterlijke pad
foo/bar/mydata.json.

Wanneer armatuurbestanden worden verwerkt, worden de gegevens ongewijzigd in de database opgeslagen. Model gedefinieerd
sparen() methoden worden niet aangeroepen, en alle vooraf opslaan or post_opslaan signalen zullen worden opgeroepen
rauw=Waar omdat de instantie alleen attributen bevat die lokaal zijn voor het model. Je kan,
U wilt bijvoorbeeld handlers uitschakelen die toegang hebben tot gerelateerde velden die niet aanwezig zijn
tijdens het laden van de armatuur en zou anders een uitzondering opleveren:

van django.db.models.signals importeer post_save
vanuit .models importeer MijnModel

def mijn_handler(**kwargs):
# schakel de handler uit tijdens het laden van de armatuur
if kwargs['rauw']:
terugkeer
...

post_save.connect(mijn_handler, afzender=MijnModel)

Je zou ook een eenvoudige decorateur kunnen schrijven om deze logica samen te vatten:

van functools import wraps

def disable_for_loaddata(signaal_handler):
"" "
Decorator die signaalbehandelaars uitschakelt bij het laden van armatuurgegevens.
"" "
@wraps(signaalafhandelaar)
def-wrapper(*args, **kwargs):
if kwargs['rauw']:
terugkeer
signaal_handler(*args, **kwargs)
retourverpakking

@disable_for_loaddata
def mijn_handler(**kwargs):
...

Houd er rekening mee dat deze logica de signalen zal uitschakelen wanneer armaturen worden gedeserialiseerd.
niet alleen tijdens laadgegevens.

Merk op dat de volgorde waarin armatuurbestanden worden verwerkt niet gedefinieerd is. Echter allemaal
armatuurgegevens worden geïnstalleerd als een enkele transactie, zodat gegevens in één armatuur kunnen verwijzen
gegevens in een ander armatuur. Als de database-backend beperkingen op rijniveau ondersteunt, worden deze
beperkingen worden aan het einde van de transactie gecontroleerd.

De dumpgegevens commando kan worden gebruikt om invoer voor te genereren laadgegevens.

Gecomprimeerde armaturen
Armaturen kunnen worden samengedrukt ritssluiting, gzof bz2 formaat. Bijvoorbeeld:

django-admin loaddata mydata.json

zou er een zoeken mijndata.json, mijndata.json.zip, mijndata.json.gzof mijndata.json.bz2.
Het eerste bestand in een zip-gecomprimeerd archief wordt gebruikt.

Houd er rekening mee dat als er twee apparaten met dezelfde naam maar met een verschillend apparaattype worden ontdekt
(bijvoorbeeld als mijndata.json en mijndata.xml.gz werden gevonden in dezelfde armatuurdirectory),
De installatie van de armatuur wordt afgebroken en alle gegevens die in de oproep zijn geïnstalleerd, worden afgebroken laadgegevens wil
uit de database worden verwijderd.

MySQL met MyISAM en armaturen

De MyISAM-opslagengine van MySQL ondersteunt geen transacties of beperkingen,
dus als u MyISAM gebruikt, krijgt u geen validatie van de armatuurgegevens, of een terugdraaiing
er zijn meerdere transactiebestanden gevonden.

Database-specifiek armaturen
Als u zich in een opstelling met meerdere databases bevindt, heeft u mogelijk armatuurgegevens die u wilt laden
op de ene database, maar niet op de andere. In deze situatie kunt u database toevoegen
identificatie in de namen van uw armaturen.

Bijvoorbeeld als uw DATABANKEN instelling heeft een 'master' database gedefinieerd, geef het armatuur een naam
mijndata.master.json or mijndata.master.json.gz en het armatuur wordt alleen geladen als u
Geef aan dat u gegevens in het meester database.

berichten maken
django-admin berichten maken

Loopt over de volledige bronboom van de huidige map en haalt alle gemarkeerde strings eruit
voor vertaling. Het creëert (of werkt bij) een berichtenbestand in de conf/locale (in de Django
tree) of locale (voor project en applicatie) map. Na het aanbrengen van wijzigingen in de
messages-bestanden waarmee u ze moet compileren berichten compileren voor gebruik met de ingebouwde
krijg tekstondersteuning. Zie de i18n documentatie voor meer info.

--alle

Gebruik de --alle or -a optie om de berichtbestanden voor alle beschikbare talen bij te werken.

Voorbeeld gebruik:

django-admin makemessages --all

--verlenging

Gebruik de --verlenging or -e optie om een ​​lijst met bestandsextensies op te geven die u wilt onderzoeken (standaard:
".html", ".txt").

Voorbeeld gebruik:

django-admin makemessages --locale=de --extension xhtml

Scheid meerdere extensies met komma's of gebruik meerdere keren -e of --extension:

django-admin makemessages --locale=de --extension=html,txt --extension xml

Gebruik de --lokale optie (of de kortere versie ervan -l) om de landinstellingen op te geven die moeten worden verwerkt.

Gebruik de --uitsluiten optie (of de kortere versie ervan -x) om de landinstellingen op te geven die u wilt uitsluiten
uit verwerking. Indien niet opgegeven, worden geen landinstellingen uitgesloten.

Voorbeeld gebruik:

django-admin makemessages --locale=pt_BR
django-admin makemessages --locale=pt_BR --locale=fr
django-admin makemessages -l pt_BR
django-admin makemessages -l pt_BR -l fr
django-admin makemessages --exclude=pt_BR
django-admin makemessages --exclude=pt_BR --exclude=fr
django-admin makemessages -x pt_BR
django-admin makemessages -x pt_BR -x fr

Toegevoegd --vorig optie voor de bericht commando bij het samenvoegen met bestaande po-bestanden.

--domein

Gebruik de --domein or -d optie om het domein van de berichtenbestanden te wijzigen. Momenteel
ondersteund:

· django alle *.py, *.html en * .txt bestanden (standaard)

· djangojs For *.js bestanden

--symbolen

Gebruik de --symbolen or -s optie om symlinks naar mappen te volgen bij het zoeken naar nieuwe
vertaalreeksen.

Voorbeeld gebruik:

django-admin makemessages --locale=de --symlinks

--negeren

Gebruik de --negeren or -i optie om bestanden of mappen te negeren die overeenkomen met het gegeven glob-Stijl
patroon. Gebruik meerdere keren om meer te negeren.

Deze patronen worden standaard gebruikt: 'CVS', '.*', '*~', '*.pyc'

Voorbeeld gebruik:

django-admin makemessages --locale=en_US --ignore=apps/* --ignore=secret/*.html

--no-default-negeren

Gebruik de --no-default-negeren optie om de standaardwaarden van uit te schakelen --negeren.

--geen-omslag

Gebruik de --geen-omslag optie om het opsplitsen van lange berichtregels in meerdere regels uit te schakelen
taal bestanden.

--geen-locatie

Gebruik de --geen-locatie optie om niet te schrijven '#: bestandsnaam:regel' commentaarregels in taal
bestanden. Houd er rekening mee dat het gebruik van deze optie het voor technisch vaardige vertalers moeilijker maakt
begrijp de context van elk bericht.

--houd-pot

Gebruik de --houd-pot optie om te voorkomen dat Django de tijdelijke foutopsporingsfouten verwijdert
waardoor mogelijk wordt voorkomen dat de definitieve taalbestanden worden gemaakt.

ONTDEK OOK:
Bekijk berichten aanpassen voor instructies over hoe u de trefwoorden kunt aanpassen
berichten maken gaat over naar xgettekst.

migraties maken [ ]
django-admin migraties maken

Creëert nieuwe migraties op basis van de gedetecteerde wijzigingen in uw modellen. Migraties, hun
relatie met apps en meer worden uitgebreid behandeld de migraties documentatie.

Als u een of meer app-namen als argumenten opgeeft, worden de migraties naar de
app(s) gespecificeerd en eventueel benodigde afhankelijkheden (de tabel aan het andere uiteinde van een Vreemde sleutel,
bijvoorbeeld).

--leeg

De --leeg optie zal veroorzaken migraties maken om een ​​lege migratie uit te voeren voor de
gespecificeerde apps, voor handmatige bewerking. Deze optie is alleen voor gevorderde gebruikers en zou dat niet moeten doen
worden gebruikt, tenzij u bekend bent met het migratieformaat, de migratiebewerkingen en de
afhankelijkheden tussen uw migraties.

--oefening

De --oefening optie laat zien welke migraties zouden worden uitgevoerd zonder er daadwerkelijk een te schrijven
migratiebestanden naar schijf. Gebruik deze optie samen met --breedsprakigheid 3 zal ook de
complete migratiebestanden die zouden worden geschreven.

--samenvoegen

De --samenvoegen optie maakt het oplossen van migratieconflicten mogelijk. De --geen input optie kan zijn
voorzien om gebruikersprompts tijdens een samenvoeging te onderdrukken.

--naam, -n

De --naam Met deze optie kunt u de migratie(s) een aangepaste naam geven in plaats van een gegenereerde naam
een.

--Uitgang, -e

De --Uitgang optie zal veroorzaken migraties maken om af te sluiten met foutcode 1 als er geen migratie is
zijn gemaakt (of zouden zijn gemaakt, indien gecombineerd met --oefening).

trekken [ [ ]]
django-admin trekken

Synchroniseert de databasestatus met de huidige set modellen en migraties.
Migraties, hun relatie met apps en meer worden uitgebreid behandeld in de migraties
documentatie.

Het gedrag van deze opdracht verandert afhankelijk van de opgegeven argumenten:

· Geen argumenten: alle migraties van alle gemigreerde apps zijn uitgevoerd en ze zijn allemaal niet meer gemigreerd
apps worden gesynchroniseerd met de database,

· : De opgegeven app laat de migraties uitvoeren, tot aan de meest recente migratie.
Dit kan inhouden dat ook de migraties van andere apps worden uitgevoerd vanwege afhankelijkheden.

· : Brengt het databaseschema naar een staat waarin de naam
migratie wordt toegepast, maar latere migraties in dezelfde app worden niet toegepast. Dit zou
het ongedaan maken van de toepassing van migraties met zich meebrengen als u eerder voorbij de genoemde migratie bent gemigreerd.
Gebruik de naam nul om de toepassing van alle migraties voor een app ongedaan te maken.

Anders syncdb, wordt u bij deze opdracht niet gevraagd een superuser te maken als deze nog niet bestaat
(ervan uitgaande dat je django.contrib.auth). Gebruik maaksupergebruiker om dat te doen als je dat wilt.

De --databank optie kan worden gebruikt om de database op te geven die moet worden gemigreerd.

--nep

De --nep optie vertelt Django om de migraties te markeren als toegepast of niet-toegepast,
maar zonder daadwerkelijk de SQL uit te voeren om uw databaseschema te wijzigen.

Dit is bedoeld voor geavanceerde gebruikers om de huidige migratiestatus rechtstreeks te manipuleren
ze passen handmatig wijzigingen toe; wees gewaarschuwd dat het gebruik --nep loopt het risico te zetten
de migratiestatustabel naar een staat waarin handmatig herstel nodig is
migraties verlopen correct.

--fake-initiaal

De --fake-initiaal optie kan worden gebruikt om Django de initiële migratie van een app te laten overslaan
als alle databasetabellen met de namen van alle modellen door iedereen zijn gemaakt MaakModel operaties
in die migratie bestaan ​​al. Deze optie is bedoeld voor gebruik bij de eerste keer hardlopen
migraties tegen een database die al bestond voor het gebruik van migraties. Deze optie is niet
controleer echter of er een overeenkomend databaseschema is dat verder gaat dan de overeenkomende tabelnamen, en dat is alleen zo
veilig te gebruiken als u er zeker van bent dat uw bestaande schema overeenkomt met wat erin is vastgelegd
uw eerste migratie.

Verouderd sinds versie 1.8: The --lijst optie is verplaatst naar de showmigraties
opdracht.

runfcgi [Opties]
django-admin runfcgi

Verouderd sinds versie 1.7: FastCGI-ondersteuning is verouderd en wordt verwijderd in Django
1.9.

Start een reeks FastCGI-processen die geschikt zijn voor gebruik met elke webserver die de
FastCGI-protocol. Zie de FastCGI inzet documentatie voor details. Vereist de
Python FastCGI-module van flap.

Intern omhult dit het WSGI-toepassingsobject dat is opgegeven door de WSGI_APPLICATIE
instellen.

De opties die door deze opdracht worden geaccepteerd, worden doorgegeven aan de FastCGI-bibliotheek en maken geen gebruik van de
'--' voorvoegsel zoals gebruikelijk voor andere Django-beheeropdrachten.

protocol

protocol=PROTOCOL

Protocol om te gebruiken. PROTOCOL kan zijn fcgi, scgi, ajp, enz. (standaard is fcgi)

gastheer

host=HOSTNAAM

Hostnaam om naar te luisteren.

port

poort=PORTNUM

Poort om naar te luisteren.

stopcontact

socket=BESTAND

UNIX-socket om op te luisteren.

methode

methode=IMPL

Mogelijke waarden: prefork or draad- (standaard prefork)

maxverzoeken

maxrequests=AANTAL

Aantal verzoeken dat een kind afhandelt voordat het wordt gedood en een nieuw kind wordt geforkt (0 betekent
geen limiet).

maxspare

maxspare=GETAL

Maximaal aantal reserveprocessen/threads.

minspare

minspare=GETAL

Min. aantal reserveprocessen/threads.

maxkinderen

maxchildren=AANTAL

Harde limiet voor het aantal processen/threads.

demoniseren

demoniseren=BOOL

Of u wilt loskoppelen van de terminal.

pidbestand

pidbestand=BESTAND

Schrijf de gegenereerde proces-ID naar een bestand FILE.

werkmap

werkmap=DIRECTORY

Verander naar map DIRECTORY bij het daemoniseren.

debug

debuggen=BOOL

Stel deze in op true om flup-tracebacks in te schakelen.

uitloggen

uitlog=BESTAND

Schrijf stdout naar de FILE bestand.

fout

errlog=BESTAND

Schrijf stderr naar de FILE bestand.

umasker

umask=UMASK

Umask om te gebruiken bij het daemoniseren. De waarde wordt geïnterpreteerd als een octaal getal (standaardwaarde
is 0o22).

Voorbeeld gebruik:

django-admin runfcgi socket=/tmp/fcgi.sock methode=prefork daemonize=true \
pidfile=/var/run/django-fcgi.pid

Voer een FastCGI-server uit als een daemon en schrijf de voortgebrachte PID in een bestand.

runserver [haven or adres:haven]
django-admin runserver

Start een lichtgewicht ontwikkelingswebserver op de lokale machine. Standaard de server
draait op poort 8000 op het IP-adres 127.0.0.1. U kunt een IP-adres en poort doorgeven
nummer expliciet.

Als u dit script uitvoert als gebruiker met normale rechten (aanbevolen), is dit mogelijk niet het geval
toegang om een ​​poort te starten op een laag poortnummer. Lage poortnummers zijn gereserveerd voor de
supergebruiker (root).

Deze server gebruikt het WSGI-toepassingsobject dat is opgegeven door de WSGI_APPLICATIE instellen.

GEBRUIK DEZE SERVER NIET IN EEN PRODUCTIE-OMGEVING. Het heeft geen beveiligingsaudits ondergaan of
Prestatie testen. (En zo zal het blijven. We zijn bezig met het maken van internet
frameworks, geen webservers, dus deze server verbeteren om een ​​productie aan te kunnen
omgeving valt buiten het bereik van Django.)

De ontwikkelingsserver laadt indien nodig automatisch de Python-code opnieuw voor elk verzoek. Jij
U hoeft de server niet opnieuw op te starten om codewijzigingen door te voeren. Wel enkele acties
zoals het toevoegen van bestanden geen herstart veroorzaakt, dus je zult de server hierin opnieuw moeten opstarten
gevallen.

Bij het compileren van vertaalbestanden wordt nu ook de ontwikkelserver opnieuw opgestart.

Als u Linux gebruikt en installeert pyinotificeren, zullen kernelsignalen worden gebruikt om automatisch te herladen
de server (in plaats van elke seconde de tijdstempels voor bestandswijzigingen op te vragen). Dit biedt
betere schaalbaarheid voor grote projecten, kortere responstijd op codewijzigingen, meer
robuuste wijzigingsdetectie en vermindering van het batterijgebruik.

pyinotificeren ondersteuning is toegevoegd.

Wanneer u de server start en elke keer dat u de Python-code wijzigt terwijl de server actief is
actief is, controleert de server uw gehele Django-project op fouten (zie de controle
commando). Als er fouten worden gevonden, worden deze afgedrukt naar de standaarduitvoer, maar dat gebeurt niet
stop de server.

U kunt zoveel servers gebruiken als u wilt, zolang ze zich maar op afzonderlijke poorten bevinden. Zojuist
uitvoeren django-admin runserver meerdere keren.

Houd er rekening mee dat het standaard IP-adres, 127.0.0.1, is niet toegankelijk vanaf andere machines op uw
netwerk. Om uw ontwikkelserver zichtbaar te maken voor andere machines in het netwerk, gebruikt u
een eigen IP-adres (bijv 192.168.2.1) Of 0.0.0.0 or :: (met IPv6 ingeschakeld).

U kunt een IPv6-adres opgeven tussen haakjes (bijv [200a::1]:8000). Dit zal
IPv6-ondersteuning automatisch inschakelen.

Er kan ook een hostnaam worden gebruikt die alleen ASCII-tekens bevat.

Indien de statische bestanden contrib-app is ingeschakeld (standaard in nieuwe projecten) de runserver commando
zal worden overschreven door zijn eigen runserver opdracht.

If trekken is nog niet eerder uitgevoerd, de tabel waarin de geschiedenis van migraties wordt opgeslagen, is dat wel
gemaakt tijdens de eerste run van runserver.

--nooit laden

Gebruik de --nooit laden optie om het gebruik van de automatische herlader uit te schakelen. Dit betekent elke Python
wijzigingen in de code die u aanbrengt terwijl de server actief is, zullen dat ook doen niet van kracht worden als het bijzondere
Python-modules zijn al in het geheugen geladen.

Voorbeeld gebruik:

django-admin runserver --noreload

--niet-threading

De ontwikkelingsserver is standaard multithreaded. Gebruik de --niet-threading optie om
schakel het gebruik van threading op de ontwikkelingsserver uit.

--ipv6, -6

Gebruik de --ipv6 (of korter -6) optie om Django te vertellen IPv6 te gebruiken voor de ontwikkeling
server. Hierdoor verandert het standaard IP-adres van 127.0.0.1 naar :: 1.

Voorbeeld gebruik:

django-admin runserver --ipv6

Voorbeelden of gebruik anders havens en adressen
Poort 8000 op IP-adres 127.0.0.1:

django-admin-runserver

Poort 8000 op IP-adres 1.2.3.4:

django-admin runserver 1.2.3.4:8000

Poort 7000 op IP-adres 127.0.0.1:

django admin runserver 7000

Poort 7000 op IP-adres 1.2.3.4:

django-admin runserver 1.2.3.4:7000

Poort 8000 op IPv6-adres :: 1:

django-admin-runserver -6

Poort 7000 op IPv6-adres :: 1:

django-admin runserver -6 7000

Poort 7000 op IPv6-adres 2001:0db8:1234:5678::9:

django-admin runserver [2001:0db8:1234:5678::9]:7000

Poort 8000 op IPv4-adres van host localhost:

django-admin runserver localhost:8000

Poort 8000 op IPv6-adres van host localhost:

django-admin runserver -6 localhost:8000

Presenteren statisch bestanden Met de ontwikkeling server
Standaard levert de ontwikkelingsserver geen statische bestanden voor uw site (zoals
CSS-bestanden, afbeeldingen, dingen eronder MEDIA_URL enzovoorts). Als u Django
om statische media te bedienen, lees /howto/static-files/index.

schelp
django-admin schelp

Start de interactieve Python-interpreter.

Django zal gebruiken IPython or python als een van beide is geïnstalleerd. Als je een rijke schaal hebt
geïnstalleerd, maar je wilt het gebruik van de "gewone" Python-interpreter forceren, gebruik dan de --vlak keuze,
zoals zo:

django-admin-shell --plain

Als u IPython of bpython als uw tolk wilt specificeren, als u dat heeft
beide zijn geïnstalleerd, kunt u een alternatieve tolkinterface opgeven met de -i or
--koppel opties zoals zo:

IPython:

django-admin shell -i ipython
django-admin shell --interface ipython

bpython:

django-admin shell -i bpython
django-admin shell --interface bpython

Wanneer de "gewone" interactieve Python-interpreter start (zij het omdat --vlak was
opgegeven of omdat er geen andere interactieve interface beschikbaar is) leest het het script
gewezen door de PYTHON OPSTARTEN omgevingsvariabele en de ~/.pythonrc.py script. als jij
Als u dit gedrag niet wenst, kunt u de --geen opstarten keuze. bijvoorbeeld:

django-admin shell --plain --no-startup

showmigraties [ [ ]]
django-admin showmigraties

Toont alle migraties in een project.

--lijst, -l

De --lijst optie geeft een overzicht van alle apps waarvan Django op de hoogte is, en de migraties waarvoor beschikbaar zijn
elke app, en of elke migratie al dan niet wordt toegepast (gemarkeerd door een [X] naast de
migratie naam).

Apps zonder migraties worden ook vermeld, maar hebben dat wel gedaan (niet migraties) eronder afgedrukt.

--plan, -p

De --plan optie toont het migratieplan dat Django zal volgen om migraties toe te passen. Elk
geleverde app-labels worden genegeerd omdat het plan mogelijk verder gaat dan die apps. Hetzelfde als
--lijst, worden toegepaste migraties gemarkeerd door een [X]. Voor een breedsprakigheid van 2 en hoger, alles
Ook de afhankelijkheden van een migratie worden getoond.

sql <app_label app_label ...>
django-admin sql

Drukt de CREATE TABLE SQL-instructies af voor de opgegeven app-naam(en).

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden afgedrukt.

ruk <app_label app_label ...>
django-admin ruk

Drukt de CREATE TABLE en SQL-instructies met initiële gegevens af voor de opgegeven app-naam (-namen).

Zie de beschrijving van sqlaangepast voor uitleg over het opgeven van initiële gegevens.

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden afgedrukt.

De sql* managementcommando's respecteren nu de allow_migrate() methode van DATABASE_ROUTERS.
Als u modellen hebt gesynchroniseerd met niet-standaarddatabases, gebruikt u de --databank vlag om SQL voor op te halen
die modellen (voorheen werden ze altijd in de uitvoer opgenomen).

sqlhelder <app_label app_label ...>
django-admin sqlhelder

Drukt de DROP TABLE SQL-instructies af voor de opgegeven app-naam(en).

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden afgedrukt.

sqlaangepast <app_label app_label ...>
django-admin sqlaangepast

Drukt de aangepaste SQL-instructies af voor de opgegeven app-naam(en).

Voor elk model in elke opgegeven app zoekt deze opdracht naar het bestand
/sql/ .sql, Waar is de opgegeven app-naam en
is de naam van het model in kleine letters. Als u bijvoorbeeld een app heeft nieuws dat omvat een
Verhaal model, sqlaangepast zal proberen een bestand te lezen nieuws/sql/verhaal.sql en voeg deze toe aan de
uitvoer van dit commando.

Er wordt verwacht dat elk van de SQL-bestanden, indien opgegeven, geldige SQL bevat. De SQL-bestanden worden doorgesluisd
rechtstreeks in de database nadat alle instructies voor het maken van tabellen van de modellen zijn uitgevoerd
uitgevoerd. Gebruik deze SQL-hook om tabelwijzigingen aan te brengen of SQL-functies in te voegen
in de databank.

Houd er rekening mee dat de volgorde waarin de SQL-bestanden worden verwerkt niet is gedefinieerd.

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden afgedrukt.

sqldropindexen <app_label app_label ...>
django-admin sqldropindexen

Drukt de DROP INDEX SQL-instructies af voor de opgegeven app-naam(en).

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden afgedrukt.

sqllush
django-admin sqllush

Drukt de SQL-instructies af die zouden worden uitgevoerd voor de doorspoelen opdracht.

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden afgedrukt.

sqlindexen <app_label app_label ...>
django-admin sqlindexen

Drukt de CREATE INDEX SQL-instructies af voor de opgegeven app-naam(en).

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden afgedrukt.

migreren
django-admin migreren

Drukt de SQL voor de genoemde migratie af. Hiervoor is een actieve databaseverbinding vereist
het zal gebruiken om beperkingsnamen op te lossen; dit betekent dat u de SQL moet genereren tegen a
kopie van de database waarop u deze later wilt toepassen.

Merk op dat migreren kleurt de uitvoer niet in.

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden gegenereerd.

--achteruit

Standaard is de gemaakte SQL bedoeld om de migratie in voorwaartse richting uit te voeren. Doorgang
--achteruit om in plaats daarvan de SQL te genereren voor het ongedaan maken van de migratie.

sqlsequentieset <app_label app_label ...>
django-admin sqlsequentieset

Drukt de SQL-instructies af voor het opnieuw instellen van reeksen voor de opgegeven app-naam(en).

Reeksen zijn indexen die door sommige database-engines worden gebruikt om het volgende beschikbare nummer bij te houden
automatisch opgehoogde velden.

Gebruik deze opdracht om SQL te genereren waarmee gevallen worden opgelost waarin een reeks niet synchroon loopt
de automatisch verhoogde veldgegevens.

De --databank optie kan worden gebruikt om de database op te geven waarvoor de SQL moet worden afgedrukt.

squashmigraties
django-admin squashmigraties

Vernietigt de migraties app_label tot en met migratienaam naar minder
migraties, indien mogelijk. De resulterende platgedrukte migraties kunnen naast de
ongeplete veilig. Voor meer informatie, lees migratie-verpletteren.

--niet-optimaliseren

Standaard zal Django proberen de bewerkingen in uw migraties te optimaliseren om de
grootte van het resulterende bestand. Doorgang --niet-optimaliseren als dit proces voor u mislukt of
het maken van onjuiste migraties, maar dien ook een Django-bugrapport in over de
gedrag, omdat optimalisatie bedoeld is om veilig te zijn.

startapp [bestemming]
django-admin startapp

Creëert een Django-app-mapstructuur voor de opgegeven app-naam in de huidige map
of de opgegeven bestemming.

Standaard bevat de aangemaakte map een modellen.py bestand en andere app-sjabloonbestanden.
(Zie de (bron) voor meer details.) Als alleen de app-naam wordt opgegeven, zal de app-map dat ook doen
worden gemaakt in de huidige werkmap.

Als de optionele bestemming wordt opgegeven, zal Django in plaats daarvan die bestaande map gebruiken
dan het maken van een nieuwe. Je kunt gebruiken '.' om de huidige werkmap aan te duiden.

Bijvoorbeeld:

django-admin startapp mijnapp /Users/jezdez/Code/mijnapp

--sjabloon

Met de --sjabloon optie kunt u een aangepaste app-sjabloon gebruiken door het pad op te geven
naar een map met het app-sjabloonbestand, of een pad naar een gecomprimeerd bestand (.tar.gz,
.tar.bz2, . Tgz, .tbz, .zip) met de app-sjabloonbestanden.

Dit zou bijvoorbeeld zoeken naar een app-sjabloon in de opgegeven map bij het maken van de
mijnapp app:

django-admin startapp --template=/Users/jezdez/Code/my_app_template mijnapp

Django accepteert ook URL's (http, https, ftp) naar gecomprimeerde archieven met de app
sjabloonbestanden, die u direct kunt downloaden en uitpakken.

Als u bijvoorbeeld profiteert van de functie van Github om opslagplaatsen als zip-bestanden beschikbaar te stellen, kunt u
kan een URL gebruiken zoals:

django-admin startapp --template=https://github.com/githubuser/django-app-template/archive/master.zip mijnapp

Wanneer Django de app-sjabloonbestanden kopieert, worden bepaalde bestanden ook weergegeven via de
template-engine: de bestanden waarvan de extensies overeenkomen met de --verlenging keuze (py standaard)
en de bestanden waarvan de namen worden doorgegeven met de --naam optie. De sjabloon verband gebruikt is:

· Elke optie die wordt doorgegeven aan de startapp opdracht (onder de ondersteunde opties van de opdracht)

· applicatie naam -- de app-naam zoals doorgegeven aan de opdracht

· app_map -- het volledige pad van de nieuw gemaakte app

· docs_versie -- de versie van de documentatie: 'ontwikkelaar' or '1.x'

WAARSCHUWING:
Wanneer de app-sjabloonbestanden worden weergegeven met de Django-sjabloonengine (standaard
allen *.py bestanden), zal Django ook alle aanwezige sjabloonvariabelen vervangen. Voor
Als een van de Python-bestanden bijvoorbeeld een docstring bevat die een bepaalde tekst uitlegt
functie gerelateerd aan sjabloonweergave, kan dit resulteren in een onjuist voorbeeld.

Om dit probleem te omzeilen, kunt u de sjabloontag templatetag om te "ontsnappen" aan de
verschillende delen van de sjabloonsyntaxis.

startproject [bestemming]
django-admin startproject

Creëert een Django-projectmapstructuur voor de opgegeven projectnaam in het huidige
map of de opgegeven bestemming.

Standaard bevat de nieuwe map manage.py en een projectpakket (met daarin een
settings.py en andere bestanden). Zie de sjabloon (bron) voor meer info.

Als alleen de projectnaam wordt opgegeven, zullen zowel de projectdirectory als het projectpakket dat zijn
genoemd en de projectmap zal worden aangemaakt in de huidige werking
directory.

Als de optionele bestemming wordt opgegeven, gebruikt Django die bestaande map als
projectmap en maak manage.py en het projectenpakket daarin. Gebruik '.' naar
geven de huidige werkmap aan.

Bijvoorbeeld:

django-admin startproject mijnproject /Users/jezdez/Code/myproject_repo

Zoals bij de startapp commando, het --sjabloon Met de optie kunt u een map of bestand opgeven
pad of URL van een aangepaste projectsjabloon. Zie de startapp documentatie voor details van
ondersteunde projectsjabloonformaten.

Dit zou bijvoorbeeld tijdens het maken zoeken naar een projectsjabloon in de opgegeven map
de mijn project project:

django-admin startproject --template=/Users/jezdez/Code/my_project_template mijnproject

Django accepteert ook URL's (http, https, ftp) naar gecomprimeerde archieven met het project
sjabloonbestanden, die u direct kunt downloaden en uitpakken.

Als u bijvoorbeeld profiteert van de functie van Github om opslagplaatsen als zip-bestanden beschikbaar te stellen, kunt u
kan een URL gebruiken zoals:

django-admin startproject --template=https://github.com/githubuser/django-project-template/archive/master.zip mijnproject

Wanneer Django de projectsjabloonbestanden kopieert, worden bepaalde bestanden ook weergegeven via de
template-engine: de bestanden waarvan de extensies overeenkomen met de --verlenging keuze (py standaard)
en de bestanden waarvan de namen worden doorgegeven met de --naam optie. De sjabloon verband gebruikt is:

· Elke optie die wordt doorgegeven aan de startproject opdracht (onder de ondersteunde opties van de opdracht)

· Naam van het project -- de projectnaam zoals doorgegeven aan de opdracht

· projectmap -- het volledige pad van het nieuw gemaakte project

· geheime sleutel -- een willekeurige sleutel voor de GEHEIME SLEUTEL het instellen van

· docs_versie -- de versie van de documentatie: 'ontwikkelaar' or '1.x'

Zie ook de weergave waarschuwing zoals vermeld voor startapp.

syncdb
django-admin syncdb

Verouderd sinds versie 1.7: deze opdracht is verouderd ten gunste van de trekken
commando, dat zowel het oude gedrag uitvoert als migraties uitvoert. Het is nu
slechts een alias voor dat commando.

alias voor trekken.

proef <app or proef identificatienummer>
django-admin proef

Voert tests uit voor alle geïnstalleerde modellen. Zien /onderwerpen/testen/index voor meer informatie.

--mislukt

De --mislukt optie kan worden gebruikt om het uitvoeren van tests te stoppen en de storing onmiddellijk te melden
nadat een test mislukt.

--testloper

De --testloper optie kan worden gebruikt om de gebruikte testrunnerklasse te beheren
testen uitvoeren. Als deze waarde wordt opgegeven, overschrijft deze de waarde die wordt opgegeven door de
TEST_RUNNER instellen.

--liveserver

De --liveserver optie kan worden gebruikt om het standaardadres waar de live server zich bevindt te overschrijven
(gebruikt met LiveServerTestCase) zal naar verwachting vanaf lopen. De standaardwaarde is
localhost: 8081.

--houddb

De --houddb optie kan worden gebruikt om de testdatabase tussen testruns te behouden. Dit heeft
het voordeel van het overslaan van zowel de creatie- als de vernietigingsacties, waardoor de
tijd om tests uit te voeren, vooral die in een grote testsuite. Als de testdatabase dat niet doet
bestaat, wordt deze bij de eerste run gemaakt en vervolgens voor elke volgende run bewaard. Elk
Niet-toegepaste migraties worden ook toegepast op de testdatabase voordat de test wordt uitgevoerd
op.

--omgekeerde

De --omgekeerde optie kan worden gebruikt om testgevallen in de tegenovergestelde volgorde te sorteren. Dit kan helpen
bij het debuggen van tests die niet goed geïsoleerd zijn en bijwerkingen hebben. Groepering by proef
klasse blijft behouden wanneer u deze optie gebruikt.

--debug-sql

De --debug-sql optie kan worden gebruikt om in te schakelen SQL logging voor mislukte testen. Als --breedsprakigheid
is 2, dan worden ook zoekopdrachten bij het behalen van tests uitgevoerd.

testserver <fixture competitieprogramma ...>
django-admin testserver

Voert een Django-ontwikkelserver uit (zoals in runserver) met behulp van gegevens van de gegeven armatuur(en).

Bijvoorbeeld deze opdracht:

django-admin testserver mydata.json

...zou de volgende stappen uitvoeren:

1. Maak een testdatabase, zoals beschreven in de-test-database.

2. Vul de testdatabase met armatuurgegevens van de gegeven armatuur. (Voor meer informatie
armaturen, zie de documentatie voor laadgegevens bovenstaande.)

3. Voert de Django-ontwikkelserver uit (zoals in runserver), wees op dit nieuw gecreëerde
testdatabase in plaats van uw productiedatabase.

Dit is op een aantal manieren nuttig:

· Als je schrijft eenheid testen van hoe uw weergaven werken met bepaalde armatuurgegevens, dat kunt u
. testserver om handmatig met de weergaven in een webbrowser te communiceren.

· Stel dat u uw Django-applicatie aan het ontwikkelen bent en een "ongerepte" kopie hebt van een
database waarmee u wilt communiceren. U kunt uw database naar een armatuur dumpen
(de ... gebruiken dumpgegevens commando, hierboven uitgelegd), gebruik dan testserver om uw web te runnen
toepassing met die gegevens. Met dit arrangement heb je de flexibiliteit om te knoeien
uw gegevens op welke manier dan ook bijwerken, wetende dat welke gegevenswijzigingen u ook aanbrengt, alleen maar een feit zijn
gemaakt naar een testdatabase.

Merk op dat deze server dat doet niet automatisch wijzigingen in uw Python-broncode detecteren (zoals
runserver doet). Het detecteert echter wel wijzigingen in sjablonen.

--adres [haven aantal or ipaddr:poort]

Te gebruiken --adres om een ​​andere poort, of IP-adres en poort, op te geven dan de standaardwaarde
127.0.0.1:8000. Deze waarde volgt exact hetzelfde formaat en dient precies hetzelfde
fungeren als argument voor de runserver opdracht.

Voorbeelden:

Om de testserver op poort 7000 te laten draaien armatuur1 en armatuur2:

django-admin testserver --addrport 7000 armatuur1 armatuur2
django-admin testserver armatuur1 armatuur2 --addrport 7000

(De bovenstaande uitspraken zijn gelijkwaardig. We nemen ze allebei op om aan te tonen dat dit zo is
Het maakt niet uit of de opties voor of na de armatuurargumenten komen.)

Om te draaien op 1.2.3.4:7000 met een proef armatuur:

django-admin testserver --addrport 1.2.3.4:7000 test

De --geen input Er kan een optie worden geboden om alle gebruikersprompts te onderdrukken.

bevestigen
django-admin bevestigen

Verouderd sinds versie 1.7: vervangen door de controle opdracht.

Valideert alle geïnstalleerde modellen (volgens de GEÏNSTALLEERDE_APPS instelling) en afdrukken
validatiefouten naar standaarduitvoer.

COMMANDO'S VOORZIEN BY ALLERLEI

Sommige opdrachten zijn alleen beschikbaar als de django.contrib applicatie dat gereedschap aan hen
is ingeschakeld. In deze sectie worden ze beschreven, gegroepeerd op hun toepassing.

django.contrib.auth
verander wachtwoord
django-admin verander wachtwoord

Deze opdracht is alleen beschikbaar als Django's authenticatie system (django.contrib.auth) is
geïnstalleerd.

Maakt het mogelijk om het wachtwoord van een gebruiker te wijzigen. Er wordt u gevraagd tweemaal het wachtwoord van de gebruiker in te voeren
opgegeven als parameter. Als ze allebei overeenkomen, wordt het nieuwe wachtwoord onmiddellijk gewijzigd. Als
Als u geen gebruiker opgeeft, zal de opdracht proberen het wachtwoord van de gebruikersnaam te wijzigen
komt overeen met de huidige gebruiker.

Gebruik de --databank optie om de database op te geven die voor de gebruiker moet worden opgevraagd. Als dat niet zo is
geleverd, zal Django de verzuim database.

Voorbeeld gebruik:

django-admin wijzig wachtwoord ringo

maaksupergebruiker
django-admin maaksupergebruiker

Deze opdracht is alleen beschikbaar als Django's authenticatie system (django.contrib.auth) is
geïnstalleerd.

Creëert een superuser-account (een gebruiker die alle rechten heeft). Dit is handig als je dat nodig hebt
om een ​​eerste superuser-account aan te maken of als u programmatisch moet genereren
superuser-accounts voor uw site(s).

Wanneer deze opdracht interactief wordt uitgevoerd, wordt om een ​​wachtwoord voor de nieuwe superuser gevraagd
rekening. Wanneer het niet-interactief wordt uitgevoerd, wordt er geen wachtwoord ingesteld en wordt er een superuser-account ingesteld
kan pas inloggen als er handmatig een wachtwoord voor is ingesteld.

--gebruikersnaam

--e-mail

De gebruikersnaam en het e-mailadres voor het nieuwe account kunnen worden opgegeven via de --gebruikersnaam
en --e-mail argumenten op de opdrachtregel. Als een van beide niet wordt geleverd,
maaksupergebruiker zal erom vragen als het interactief wordt uitgevoerd.

Gebruik de --databank optie om de database op te geven waarin het superuser-object zal worden geplaatst
opgeslagen.

U kunt de beheeropdracht subclassificeren en overschrijven get_input_data() als je wilt
gegevensinvoer en -validatie aanpassen. Raadpleeg de broncode voor details over de bestaande
implementatie en de parameters van de methode. Het kan bijvoorbeeld handig zijn als u een
Vreemde sleutel in VERPLICHTE VELDEN en wilt toestaan ​​dat er een exemplaar wordt gemaakt in plaats van binnen te gaan
de primaire sleutel van een bestaand exemplaar.

django.contrib.gis
ogrispect
Deze opdracht is alleen beschikbaar als GeoDjango (django.contrib.gis) is geinstalleerd.

Raadpleeg zijn beschrijving in de GeoDjango-documentatie.

django.contrib.sessies
clearsessies
django-admin clearsessies

Kan worden uitgevoerd als een cron-taak of rechtstreeks om verlopen sessies op te schonen.

django.contrib.sitemaps
ping_google
Deze opdracht is alleen beschikbaar als de Sitemaps kader (django.contrib.sitemaps) is
geïnstalleerd.

Raadpleeg zijn beschrijving in de sitemapdocumentatie.

django.contrib.staticfiles
collectstatisch
Deze opdracht is alleen beschikbaar als de statisch bestanden toepassing
(django.contrib.staticfiles) is geinstalleerd.

Raadpleeg zijn beschrijving in de statische bestanden documentatie.

vind statisch
Deze opdracht is alleen beschikbaar als de statisch bestanden toepassing
(django.contrib.staticfiles) is geinstalleerd.

Raadpleeg zijn beschrijving in de statische bestanden documentatie.

DEFAULT OPTIES

Hoewel sommige opdrachten hun eigen aangepaste opties toestaan, staat elke opdracht de
volgende opties:

--pythonpad

Voorbeeld gebruik:

django-admin migreren --pythonpath='/home/djangoprojects/mijnproject'

Voegt het opgegeven bestandssysteempad toe aan Python importeren search pad. Als dit niet wordt verstrekt,
django-admin zal de gebruiken PYTHONPAD variabele omgeving.

Merk op dat deze optie niet nodig is in manage.py, omdat het zorgt voor het instellen van de
Python-pad voor jou.

--instellingen

Voorbeeld gebruik:

django-admin migreren --settings=mijnsite.settings

Specificeert expliciet welke instellingenmodule moet worden gebruikt. De instellingenmodule zou in Python moeten zijn
pakketsyntaxis, bijv mijnsite.instellingen. Als dit niet wordt verstrekt, django-admin zal de gebruiken
DJANGO_SETTINGS_MODULE variabele omgeving.

Merk op dat deze optie niet nodig is in manage.py, omdat het gebruikt settings.py van het
standaard project.

--herleiden

Voorbeeld gebruik:

django-admin migreren --traceback

Standaard django-admin toont een eenvoudige foutmelding wanneer een CommandFout gebeurt,
maar een volledige stacktracering voor elke andere uitzondering. Als u specificeert --herleiden, django-admin
zal ook een volledige stacktrace uitvoeren wanneer a CommandFout wordt verhoogd.

--breedsprakigheid

Voorbeeld gebruik:

django-admin migreren --breedsprakigheid 2

Te gebruiken --breedsprakigheid om de hoeveelheid meldings- en foutopsporingsinformatie op te geven
django-admin moet naar de console worden afgedrukt.

· 0 betekent geen output.

· 1 betekent normale uitvoer (standaard).

· 2 betekent uitgebreide uitvoer.

· 3 middel zeer uitgebreide uitvoer.

--geen kleur

Voorbeeld gebruik:

django-admin sqlall --geen kleur

Standaard django-admin formatteert de uitvoer die moet worden ingekleurd. Er zullen bijvoorbeeld fouten optreden
worden in rood naar de console afgedrukt en de syntaxis van SQL-instructies wordt gemarkeerd. Voorkomen
dit en heb een platte tekstuitvoer, geef de --geen kleur optie bij het uitvoeren van uw opdracht.

GEMEENSCHAPPELIJKE OPTIES

De volgende opties zijn niet bij elke opdracht beschikbaar, maar zijn gemeenschappelijk voor een getal
van commando's.

--databank

Wordt gebruikt om de database op te geven waarop een opdracht zal werken. Indien niet gespecificeerd, dit
optie zal standaard een alias van hebben verzuim.

Om bijvoorbeeld gegevens uit de database met de alias te dumpen meester:

django-admin dumpdata --database=master

--uitsluiten

Sluit een specifieke toepassing uit van de toepassingen waarvan de inhoud wordt uitgevoerd. Voor
bijvoorbeeld om specifiek uit te sluiten auth toepassing uit de uitvoer van dumpdata, u
zou bellen:

django-admin dumpdata --exclude=auth

Als u meerdere applicaties wilt uitsluiten, gebruik dan meerdere --uitsluiten richtlijnen:

django-admin dumpdata --exclude=auth --exclude=contenttypes

--lokale

Gebruik de --lokale or -l optie om de landinstelling op te geven die moet worden verwerkt. Indien niet alles verstrekt
landinstellingen worden verwerkt.

--geen input

Gebruik de --geen input optie om alle gebruikersvragen, zoals 'Weet je het zeker?' te onderdrukken.
bevestigingsberichten. Dit is handig als django-admin wordt uitgevoerd als een onbeheerde,
geautomatiseerd script.

EXTRA NUTTIGHEDEN

Syntaxis kleur
De django-admin / manage.py commando's zullen mooie kleurgecodeerde uitvoer gebruiken als uw terminal
ondersteunt ANSI-gekleurde uitvoer. Het gebruikt de kleurcodes niet als u de commando's doorstuurt
uitvoer naar een ander programma.

Onder Windows ondersteunt de native console standaard geen ANSI-escape-reeksen
er is geen kleuruitvoer. Maar je kunt de ANSICON tool van derden, de Django
commando's zullen de aanwezigheid ervan detecteren en gebruik maken van zijn diensten om alleen kleuruitvoer te maken
zoals op Unix-gebaseerde platforms.

De kleuren die worden gebruikt voor syntaxisaccentuering kunnen worden aangepast. Django wordt geleverd met drie kleuren
paletten:

· donker, geschikt voor terminals die witte tekst op een zwarte achtergrond weergeven. Dit is de
standaardpalet.

· licht, geschikt voor terminals die zwarte tekst op een witte achtergrond weergeven.

· geen kleur, waardoor syntaxisaccentuering wordt uitgeschakeld.

U selecteert een palet door a in te stellen DJANGO_COLORS omgevingsvariabele om de
palet dat u wilt gebruiken. Om bijvoorbeeld de licht palet onder Unix of OS/X
BASH-shell, voert u het volgende uit vanaf een opdrachtprompt:

export DJANGO_COLORS = "licht"

U kunt ook de gebruikte kleuren aanpassen. Django specificeert een aantal rollen in
welke kleur is gebruikt:

· fout - Een grote fout.

· kennisgeving - Een kleine fout.

· sql_veld - De naam van een modelveld in SQL.

· sql_coltype - Het type van een modelveld in SQL.

· sql_trefwoord - Een SQL-trefwoord.

· sql_tabel - De naam van een model in SQL.

· http_info - Een 1XX HTTP-informatieve serverreactie.

· http_succes - Een 2XX HTTP Success-serverreactie.

· http_niet_gewijzigd - Een 304 HTTP Niet Gewijzigd serverantwoord.

· http_omleiding - Een 3XX HTTP Redirect-serverantwoord anders dan 304.

· http_niet_gevonden - Een 404 HTTP Not Found-serverreactie.

· http_slechte_aanvraag - Een 4XX HTTP Bad Request-serverantwoord anders dan 404.

· http_server_fout - Een 5XX HTTP-serverfoutreactie.

Aan elk van deze rollen kan een specifieke voorgrond- en achtergrondkleur worden toegewezen
volgende lijst:

· zwart

· rood

· groen

· geel

· blauw

· magenta

· cyaan

· wit

Elk van deze kleuren kan vervolgens worden aangepast met behulp van de volgende weergaveopties:

· pin

· benadrukken

· knipperen

· omkeren

· verbergen

Een kleurspecificatie volgt een van de volgende patronen:

· rol=fg

· rol=fg/bg

· rol=fg,optie,optie

· rol=fg/bg,optie,optie

WAAR rol is de naam van een geldige kleurrol, fg is de voorgrondkleur, bg is de
achtergrondkleur en elk optie is een van de kleurwijzigingsopties. Meerdere kleuren
specificaties worden vervolgens gescheiden door een puntkomma. Bijvoorbeeld:

export DJANGO_COLORS="fout=geel/blauw,knipperen;notice=magenta"

zou specificeren dat fouten worden weergegeven met knipperend geel op blauw, en mededelingen
weergegeven met magenta. Alle andere kleurrollen zouden ongekleurd blijven.

Kleuren kunnen ook worden gespecificeerd door een basispalet uit te breiden. Als u een paletnaam in a
kleurspecificatie, worden alle kleuren die door dat palet worden geïmpliceerd, geladen. Dus:

export DJANGO_COLORS="licht;fout=geel/blauw,knipperen;notice=magenta"

zou het gebruik van alle kleuren in het lichte kleurenpalet specificeren, behalve voor de kleuren
voor fouten en mededelingen die, zoals gespecificeerd, worden overschreven.

Ondersteuning voor kleurgecodeerde uitvoer van django-admin / manage.py hulpprogramma's op Windows door
vertrouwen op de ANSICON-applicatie werd toegevoegd in Django 1.7.

Slaan voltooiing
Als u de Bash-shell gebruikt, overweeg dan om het Django bash-voltooiingsscript te installeren
woont in extra's/django_bash_completion in de Django-distributie. Het maakt mogelijk
tabblad-voltooiing van django-admin en manage.py commando's, zodat u bijvoorbeeld...

· Typ django-admin.

· Druk op [TAB] om alle beschikbare opties te zien.

· Typ sqlen vervolgens [TAB] om alle beschikbare opties te zien waarvan de naam begint met sql.

Bekijk /howto/custom-management-commands voor hoe u aangepaste acties kunt toevoegen.

django.core.management.call_command(naam, *argumenten, **opties)

Om een ​​beheeropdracht aan te roepen vanuit codegebruik call_commando.

naam de naam van het commando dat moet worden aangeroepen.

*argumenten een lijst met argumenten die door de opdracht worden geaccepteerd.

**opties
benoemde opties geaccepteerd op de opdrachtregel.

Voorbeelden:

van django.core importbeheer
management.call_command('flush', breedsprakigheid=0, interactief=False)
management.call_command('loaddata', 'test_data', breedsprakigheid=0)

Houd er rekening mee dat opdrachtopties die geen argumenten aannemen, als sleutelwoorden worden doorgegeven Waar or
Niet waar, zoals je kunt zien met de interactieve optie hierboven.

Benoemde argumenten kunnen worden doorgegeven met behulp van een van de volgende syntaxis:

# Vergelijkbaar met de opdrachtregel
management.call_command('dumpdata', '--natural-foreign')

# Benoemd argument vergelijkbaar met de opdrachtregel minus de eerste streepjes en
# waarbij interne streepjes zijn vervangen door onderstrepingstekens
management.call_command('dumpdata', natural_foreign=True)

# `use_natural_foreign_keys` is de bestemmingsvariabele van de optie
management.call_command('dumpdata', use_natural_foreign_keys=True)

De eerste syntaxis wordt nu ondersteund dankzij beheeropdrachten die gebruik maken van de argparse module.
Voor de tweede syntaxis heeft Django eerder de optienaam zoals deze nu aan de opdracht doorgegeven
het maakt altijd gebruik van de dest variabelenaam (die al dan niet hetzelfde kan zijn als de optie
naam).

Opdrachtopties die meerdere opties hebben, krijgen een lijst door:

management.call_command('dumpdata', include=['contenttypes', 'auth'])

OUTPUT OMLEIDING

Houd er rekening mee dat u standaarduitvoer- en foutstromen kunt omleiden, aangezien alle opdrachten de
stdout en stderr opties. Je zou bijvoorbeeld kunnen schrijven:

met open('/tmp/command_output') als f:
management.call_command('dumpdata', stdout=f)

Gebruik django-admin online met behulp van onworks.net-services