Changes between Version 1 and Version 2 of TracAdmin

Timestamp:

11/04/11 12:45:10 (20 months ago)

Author:

trac

Comment:

--

TracAdmin

@@ -2 +2 @@
 [[TracGuideToc]]
 
-Trac é distribuido com uma poderosa ferramenta de configuração. Esta ferramenta pode ser usada
-para configurar e customizar a instalação do seu Trac para melhor se adaptar às suas necessidades.
+Trac is distributed with a powerful command-line configuration tool. This tool can be used  to configure and customize your Trac-installation to better fit your needs.
 
-== Uso ==
+Some of those operations can also be performed via the ''Admin'' web interface, an updated version of the [http://trac.edgewall.org/wiki/WebAdmin WebAdmin] plugin now integrated within Trac (since version 0.11).
 
+== Usage ==
+
+You can get a comprehensive list of the available options, commands and sub-commands by invoking `trac-admin` with the `help` command:.
 {{{
-Uso: trac-admin </path/to/projenv> [comando [subcomando] [opção ...]]
-
-Invoque o trac-admin sem nenhum comando para iniciar o modo interativo.
-
-about                                              -- Mostra informações sobre o trac-admin.
-help                                               -- Mostra documentação.                
-initenv                                            -- Cria e inicializa um novo ambiente interativamente.
-initenv <projectname> <repospath> <templatepath>   -- Cria e inicializa um novo ambiente a partir dos argumentos.
-hotcopy <backuodiretorio>                          -- Faz um backup de um ambiente.
-resync                                             -- Resincroniza o trac com o repositório.
-upgrade                                            -- Atualiza o banco de dados para a versão atual.
-wiki list                                          -- Lista páginas wiki.
-wiki export <página> [arquivo]                     -- Exporta páginas wiki para arquivo ou outro dispositivo de saída.
-wiki import <página> [arquivo]                     -- Importa páginas wiki de arquivo ou outro dispositivo de entrada.
-wiki dump <diretório>                              -- Exporta todas as páginas wiki para arquivos organizadas pelo nome.
-wiki load <diretório>                              -- Importa todas as páginas wikis de um diretório.
-wiki upgrade                                       -- Atualiza as páginas wikis para versão atual.
-permission list                                    -- Lista as regras de permissão.
-permission add <usuário> <ação> [ação] [...]       -- Adiciona uma nova regra de permissão.
-permission remove <usuário> <ação> [ação] [...]    -- Remove regras de permissão.
-component list                                     -- Mostra componentes disponíveis.
-component add <nome> <dono>                        -- Adiciona um novo componente.
-component rename <nome> <novonome>                 -- Renomeia um componente.
-component remove <nome>                            -- Remove/desinstala um componente.
-component chown <nome> <done>                      -- Altera proprietário do componente
-priority list                                      -- Apresenta as prioridades possíveis de um ticket.
-priority add <valor>                               -- Adiciona um valor da prioridade.
-priority change <valor> <novovalor>                -- Muda o valor de uma prioridade.
-priority remove <valor>                            -- Revome valor de uma prioridade.
-severity list                                      -- Mostra as possíveis prioridades de um ticket.
-severity add <valor>                               -- Adciona um valor a importância.
-severity change <valor> <novovalor>                -- Muda valor da importância.                           
-severity remove <valor>                            -- Remove valor atribuido a importância.
-version list                                       -- Mostra as versões.
-version add <nome> [hora]                          -- Adiciona uma versão.
-version rename <nome> <novonome>                    -- Renomeia uma versão.
-version time <nome> <hora>                         -- Ajusta a data de uma versão (Formato: "Jun 3, 2003").
-version remove <nome>                              -- Remove uma versão.                   
-milestone list                                     -- Mostra os milestones.
-milestone add <nome> [hora]                        -- Adiciona um milestone.
-milestone rename <nome> <novonome>                 -- Renomeia milestone.
-milestone time <nome> <hora>                       -- Ajusta a data de milestone (Formato: "Jun 3, 2003").
-milestone remove <nome>                            -- Remove um milestone.                  
+trac-admin help
 }}}
 
-== Modo Interativo ==
+Unless you're executing the `help`, `about` or `version` sub-commands, you'll need to specify the path to the TracEnvironment that you want to administer as the first argument, for example:
+{{{
+trac-admin /path/to/projenv wiki list
+}}}
 
-Quando é passado uma único arquivo como argumento para o banco de dados, '''trac-admin''' é inicializado no modo interativo.
-Comandos podem então ser executados em um banco de dados usando-se o prompt, o qual oferece completação com tab 
-(não em ambientes Windows) e repetição automática do último comando usado.
+== Interactive Mode ==
 
-== Uma nota sobre Configuração ==
-Para a configuração do ambiente do Trac, o Trac 0.7 introduz um novo formato de armazenamento, incluindo um arquivo de configuração separado. Veja TracIni para mais informações.
+When passing the environment path as the only argument, `trac-admin` starts in interactive mode.
+Commands can then be executed on the selected environment using the prompt, which offers tab-completion
+(on non-Windows environments, and when the Python `readline` module is available) and automatic repetition of the last command issued.
+
+Once you're in interactive mode, you can also get help on specific commands or subsets of commands:
+
+For example, to get an explanation of the `resync` command, run:
+{{{
+> help resync
+}}}
+
+To get help on all the Wiki-related commands, run:
+{{{
+> help wiki
+}}}
+
+== Full Command Reference ==
+
+[[TracAdminHelp()]]
 
 
+=== Notes ===
+
+The `initenv` also supports an extra `--inherit` option, which can be used to specify the `[inherit] file` option at environment creation time so that only the options ''not'' already specified in the global configuration file will be written in the conf/trac.ini file of the newly created environment.
+See TracIni#GlobalConfiguration.
+
+Note that in version 0.11 of Trac, `initenv` lost an extra last argument `<templatepath>`, which was used in previous versions to point to the `templates` folder. If you are using the one-liner '`trac-admin /path/to/trac/ initenv <projectname> <db> <repostype> <repospath>`' in the above and getting an error that reads ''''`Wrong number of arguments to initenv: 4`'''', then this is because you're using a `trac-admin` script from an '''older''' version of Trac.
+
 ----
-Veja também: TracGuide, TracBackup, TracPermissions. TracEnvironment, TracIni
+See also: TracGuide, TracBackup, TracPermissions, TracEnvironment, TracIni, [trac:TracMigrate TracMigrate]