Os nomes de arquivo especificados no arquivo .pluginmap são considerados relativos ao diretório do arquivo .pluginmap + o prefixo especificado aqui. Útil, especialmente se todos os seus componentes estiverem localizados em um único subdiretório.

Um espaço de nomes para os IDs dos componentes. Ao procurar componentes para incorporação, os componentes poderão ser recuperados por meio da string "namespace::component_id". Definido como "rkward" por enquanto.

Uma string identificadora opcional para este .pluginmap. Especificar isso permite que autores terceirizados se refiram ao seu .pluginmap e o carreguem a partir do deles (consulte o capítulo sobre como lidar com dependências).

Uma das opções "hidden", "low", "medium" ou "high". Os .pluginmap com prioridade "medium" ou "high" são ativados automaticamente quando o RKWard os encontra pela primeira vez. Use priority="hidden" para .pluginmaps que não devem ser ativados, diretórios (apenas para inclusão). Na implementação atual, isso não oculta o .pluginmap. (Opcional, o padrão é "medium").

Versão mínima e máxima permitida do RKWard. As especificações de versão podem incluir sufixos não numéricos, como "0.5.7z-devel1". Se uma dependência especificada não for atendida, o(s) plugin(s) ao(s) qual(is) ela se aplica serão ignorados. Mais informações. Opcional; se não for especificado, nenhuma versão mínima/máxima do RKWard será exigida.

Versão mínima e máxima permitida do R. As especificações de versão não podem incluir sufixos não numéricos, como "0.5.7z-devel1". A dependência da versão do R será exibida nas páginas de ajuda dos plugins, mas não tem efeito direto, a partir da versão 0.6.1 do RKWard. Mais informações. Opcional; se não for especificado, nenhuma versão mínima/máxima do R será exigida.

Plataformas onde este plugin está disponível. Os valores suportados são "unix", "windows", "macos", "any" e combinações separadas por dois pontos (por exemplo, "unix:macos"). "unix" inclui quaisquer variantes de Linux e BSD, mas não MacOS. Se o seu plugin não depender de plataforma, basta omitir este atributo.

Adiciona uma dependência a um pacote R específico. Atributos:

Adiciona uma dependência a um específico .pluginmap do RKWard. Atributos:

Nome visível do usuário. Opcional. Não precisa ser o mesmo que o "id".

Número da versão. Opcional. O formato não é restrito, mas para maior segurança, siga esquemas de versionamento comuns, como "x.y.z".

Especificação da data de lançamento. Opcional, no formato "YYYY-MM-DD".

Uma breve descrição do plugin / .pluginmap. Opcional.

URL onde você pode encontrar mais informações. Opcional, mas recomendado.

Especificação de direitos autorais, por exemplo: "2012-2013 por John Doe". Opcional, mas recomendado.

Especificação da licença, por exemplo, "GPL" ou "BSD". Certifique-se de acompanhar seus arquivos com uma cópia completa da licença relevante. Opcional, mas recomendado.

Categoria de plugin(s), por exemplo, "Teoria de resposta ao item". A partir da versão 0.6.1, nenhuma categoria está predefinida. Opcional.

Adiciona informações sobre um autor. Atributos:

Para futuras extensões: O tipo de componente/plugin. Por enquanto, sempre definido como "padrão" (o único tipo atualmente suportado).

O ID pelo qual este componente pode ser recuperado (para colocá-lo no menu (veja abaixo), ou para incorporá-lo). Veja <document>-namespace acima.

Requerido pelo menos para componentes do tipo "padrão": O nome do arquivo XML que descreve a GUI.

A legenda para este componente, quando colocado na hierarquia do menu.

Só faz sentido para componentes com dependencies definidas: Normalmente, é considerado um erro reportável se um componente não for compatível com esta versão do RKWard. No entanto, se o componente realmente não for necessário no ambiente atual, definir este atributo como "true" suprime qualquer aviso ("false" por padrão).

Id do atributo

Valor do atributo

Legenda associada ao atributo

Uma string identificadora do menu. Útil quando as definições de menu são lidas de vários arquivos .pluginmap para garantir que os plugins possam ser colocados no(s) mesmo(s) menu(s). Alguns IDs de menu, como "file", referem-se a menus predefinidos (neste caso, o menu "File"). Certifique-se de verificar os arquivos .pluginmap existentes para usar IDs consistentes.

Uma legenda para o menu.

Permite controlar a ordem dos itens do menu. Consulte ordem dos itens do menu. Opcional.

O ID do componente que deve ser invocado quando esta entrada de menu for ativada.

Permite controlar a ordem dos itens do menu. Consulte ordem dos itens do menu. Opcional.

O nome deste grupo.

Opcional. Se definido como "verdadeiro", o item neste grupo será visualmente separado dos itens ao redor.

Nome do grupo ao qual este grupo será adicionado (opcional).

O ID do contexto. Até o momento, apenas dois contextos foram implementados: "x11" e "import".

O nome do arquivo do .pluginmap a ser incluído. Isso é visto em relação ao diretório do arquivo .pluginmap atual + o prefixo base (veja acima, elemento <document>). Se você não souber o caminho relativo para o .pluginmap a ser incluído, use o atributo map para referenciá-lo pelo id.

Para incluir um arquivo .pluginmap de um pacote diferente (ou um .pluginmap do RKWard de seu .pluginmap externo), você pode se referir a ele pelo seunamespacename::id, conforme especificado no elemento<document> do .pluginmap obrigatório. A inclusão falhará se nenhum .pluginmap com esse id for conhecido (por exemplo, não estiver instalado no sistema do usuário). Você deve usar este método apenas para incluir .pluginmaps fora do seu pacote. Para mapas dentro do seu pacote, especificar um caminho relativo (atributo file) é mais rápido e confiável.