Manual:Pywikibot/pagefromfile.py/cs

<translate> Wikimedia [[<tvar|1>Special:MyLanguage/Gerrit</>|Git repository]] has this file:</translate> scripts/cs

pagefromfile.py je skript Pywikibota používaný k nahrávání stránek na wiki z textového souboru.

Tento robot bere svůj vstup z textového souboru UTF-8, který obsahuje několik stránek, které mají být umístěny na wiki. Všechny stránky by měly mít stejný začátek a konec textu (který se nesmí překrývat). Počáteční a koncový text není ve výchozím nastavení nahrán s obsahem stránky.

Název stránky je ve výchozím nastavení převzat z prvního textového bloku obsahu stránky, který je označen tučně (zalomený mezi ''' a '''). Pokud očekáváte, že název stránky nebude v textu uveden nebo označen jinými značkami, použijte parametry -titlestart, -titleend a -notitle.

Specifické parametry

<translate> Parameter</translate>	<translate> Description</translate>
`-file:xxx`	Název souboru, ze kterého získáváme náš materiál, výchozí hodnota je "dict.txt". Notice that if the source file name contains any space character, you should wrap it with double quotations (i.e. `-file:"Page title"`).
`-begin:xxx`	Text, který označuje začátek stránky, výchozí hodnota je "{{-start-}}"
`-end:xxx`	Text, který označuje konec stránky, výchozí hodnota je "{{-stop-}}"
`-include`	Přidejte na stránku značky začátku a konce
`-textonly`	Text je uveden bez značek. Je uveden pouze text na jedné stránce. Možnosti -begin a -end jsou ignorovány.
`-titlestart:xxx`	Text použitý místo ''' pro identifikaci začátku názvu stránky
`-titleend:xxx`	Text použitý místo ''' pro identifikaci konce nadpisu stránky
`-notitle`	Nevkládejte na stránku název stránky, včetně titlestartu a titleendu. Lze použít k určení jedinečného názvu stránky nad obsahem stránky
`-title:xxx`	Název stránky je uveden přímo. Ignoruje možnosti -titlestart, -titleend a -notitle
`-nocontent:xxx`	Pokud existující stránka obsahuje zadaný příkaz, stránka se z úprav vynechá
`-noredirect`	Nenahrávejte na stránky s přesměrováním
`-summary:xxx`	Text použitý jako souhrn úprav pro nahrání. Pokud stránka existuje, jsou za ni připojeny standardní zprávy pro předřazení, připojení nebo nahrazení
`-autosummary`	Při vytváření nové stránky použijte autosummary MediaWiki, přepíše `-summary`
`-minor`	Nastavte příznak drobných úprav při úpravách stránky
`-showdiff`	Zobrazit rozdíl mezi aktuální stránkou a stránkou k nahrání, také přinutí robota požádat o potvrzení při každé úpravě

Pokud stránka k nahrání již existuje, je ve výchozím nastavení přeskočena. Toto chování však můžete přepsat, pokud chcete:

<translate> Parameter</translate>	<translate> Description</translate>
`-appendtop`	Přidejte text do horní části stávající stránky
`-appendbottom`	Přidejte text na konec stávající stránky
`-force`	Přepsat existující stránku

Za režimy 'append' je možné definovat oddělovač, který je přidán mezi stávající a nový text. Například parametr -appendtop:foo by mezi ně přidal 'foo'. Mezi ně lze přidat nový řádek zadáním hodnoty '\n'.

Příklady

Základní ukázka

V nejzákladnější formě, pagefromfile bere jako vstup jeden textový soubor s několika wiki stránkami. Obsah může být například:

{{-start-}}
'''Pywikibot''' je knihovna Pythonu a sbírka skriptů, které automatizují práci na stránkách MediaWiki.
Původně byl navržen pro Wikipedii, nyní se používá v projektech Wikimedia Foundation a na mnoha dalších wikinách.
{{-stop-}}
{{-start-}}
'''AutoWikiBrowser''' (často zkráceně '''AWB''') je poloautomatický editor MediaWiki navržený tak, aby zrychlil a usnadnil únavné nebo opakující se úpravy.
{{-stop-}}

Uložte to jako textový soubor s kódováním UTF-8, například jako 'pages.txt'. Poté můžete spustit python pwb.py pagefromfile -showdiff -file:pages.txt. To robotovi umožní vytvořit Pywikibot a AutoWikiBrowser – první '''bolded''' prvky na obou stránkách. -showdiff vám dá příležitost zkontrolovat změny před jejich provedením.

Různé názvy stránek

První tučný prvek často nemusí být nutně správný název stránky. Místo toho bychom mohli například chtít umístit článek o AutoWikiBrowser na AWB. Chcete-li to provést, přidejte před každý článek řádek se správným názvem stránky mezi trojitými uvozovkami (tj. tučně):

{{-start-}}
'''Pywikibot'''
'''Pywikibot''' je knihovna Pythonu a sbírka skriptů, které automatizují práci na stránkách MediaWiki.
Původně byl navržen pro Wikipedii, nyní se používá v projektech Wikimedia Foundation a na mnoha dalších wikinách.
{{-stop-}}
{{-start-}}
'''AWB'''
'''AutoWikiBrowser''' (často zkráceně '''AWB''') je poloautomatický editor MediaWiki navržený tak, aby zrychlil a usnadnil únavné nebo opakující se úpravy.
{{-stop-}}

a do volání přidejte parametr -notitle, tj.: python pwb.py pagefromfile -showdiff -file:pages.txt -notitle.

<translate> Global arguments available</translate>

<translate> These options will override the configuration in <tvar|1>user-config.py </> settings. </translate>

<translate> Global options</translate>
<translate> Parameter</translate>	<translate> Description</translate>	<translate> Config variable</translate>
`-dir:<translate> PATH</translate>`	<translate> Read the bot's configuration data from directory given by PATH, instead of from the default directory.</translate>
`-config:<translate> file</translate>`	<translate> The user config filename.</translate> Default is user-config.py.	`user-config.py`
`-configfile>user-config.py</>. <tvar`	xx>xx</> should be the language code.</translate>	`mylang`
`-configfile>user-config.py</>.</translate>`	<translate> Set the family of the wiki you want to work on, e.g. wikipedia, wiktionary, wikitravel, ...</translate> <translate> This will override the configuration in <tvar	`family`
`-xyz>xyz</>' instead of the default username.</translate>`	<translate> Log in as user '<tvar	`usernames`
`-xyz>xyz</>. (only use for bots that require no input from stdin).</translate>`	<translate> Immediately return control to the terminal and redirect stdout and stderr to file <tvar
`-help`	<translate> Show the help text.</translate>
`-1>-bot.log</>' Logs will be stored in the logs subdirectory.</translate>`	<translate> Enable the log file, using the default filename 'script_name<tvar	`log`
`-xyz>xyz</>' as the filename.</translate>`	<translate> Enable the log file, using '<tvar	`logfilename`
`-nolog`	<translate> Disable the log file (if it is enabled by default).</translate>
`-1>config.py</></translate>`	<translate> Sets a new maxlag parameter to a number of seconds.</translate> <translate> Defer bot edits during periods of database server lag. Default is set by <tvar	`maxlag`
`-putthrottle:n` `-pt:n` `-put_throttle:n`	<translate> Set the minimum time (in seconds) the bot will wait between saving pages.</translate>	`put_throttle`
`-debug:item` `-debug`	<translate> Enable the log file and include extensive debugging data for component "item" (for all components if the second form is used).</translate>	`debug_log`
`-verbose` `-v`	<translate> Have the bot provide additional console output that may be useful in debugging.</translate>	`verbose_output`
`-cosmetic>cosmetic_changes</> setting made in <tvar` `-cc`	config>config.py</> or <tvar	`cosmetic_changes`
`-simulate`	<translate> Disables writing to the server.</translate> <translate> Useful for testing and debugging of new code (if given, doesn't do any real changes, but only shows what would have been changed).</translate>	`simulate`
`-<<translate> config var</translate>>:n`	<translate> You may use all given numeric config variables as option and modify it with command line.</translate>