Usuário(a):SuggestBot/suggest

Documentação[ver] [editar] [histórico] [purgar]

Texto original em inglês

This page explains how to try SuggestBot out by making it send you suggestions only once. We use a template for this because it is relatively easy to use, while also making us able to automate the process of sending out suggestions. As this document will explain, it also provides you with the possibility to influence what pages the suggestions are based on. SuggestBot removes the template automatically at the same time as it sends you the suggestions, thus ensuring that you only get suggestions once. If you are wondering what SuggestBot is and how it works, please see SuggestBot. How you make SuggestBot send you suggestions depends on what you already have done: If you haven't already edited any pages you need to tell SuggestBot what you're interested in. If you have already edited pages you may: get suggestions based on the pages you've edited, or get suggestions based on a specific set of pages. Should anything in this documentation be confusing or unclear, we appreciate questions and suggestions for improvements on our talk page. Suggestions based on the pages you've edited This is the way SuggestBot usually works, it fetches your last few hundred edits and suggests articles that are similar and in need of improvement. To get such a set of suggestions, add the following code to your user talk page: {{Usuário(a):SuggestBot/suggest}} You can also add this template code to a page in your userspace (e.g. "User:Example/Suggestions") and have them posted there instead of on your user talk page. We look for users who have added the template code at regular intervals, so you should therefore get the suggestions fairly quickly, usually within about fifteen minutes. Suggestions based on specific pages You can tell SuggestBot exactly which pages it should base its suggestions on, which gives you the opportunity to potentially receive a set of suggestions limited to a certain area of interest. If you do this the bot will not look at your recent edits and can therefore end up suggesting articles you've recently edited, but it will not suggest any of the articles you've specified. As an example, let's assume you are interested in World War I and World War II. Wikipedia has specific pages about these subjects, so we can specify that SuggestBot should use these as the basis of the suggestions by listing them in the template code separated by "|", like this: {{Usuário(a):SuggestBot/suggest|World War I|World War II}} Unfortunately SuggestBot does not work very well with such a low number of pages, which is why we have also made it possible to specify names of Wikipedia categories, which it will then fetch page titles from. Going back to our example using World War I & II, we can use the fact that Wikipedia also has categories about these subjects (Category:World War I and Category:World War II) and tell SuggestBot to use all the articles from these categories: {{Usuário(a):SuggestBot/suggest|Category:World War I|Category:World War II}} SuggestBot will use up to 128 pages from the listed categories and post suggestions based on those. It does not look at subcategories, so if a category has a subcategory you are interested in you will also have to list the subcategory. It is of course also possible to mix pages and categories in the listing, like this: {{Usuário(a):SuggestBot/suggest|World War I|World War II|Category:Politics of World War II}} In summary the template code consists of the name of the template ("User:SuggestBot/suggest") followed by either "|" and the title of a page, or "|" and the title of a category, as many times as necessary. More formally defined using the Extended Backus–Naur Form, the format of the template code for a "suggestion" is as follows: suggestion = "{{" TemplateName [ Pages ] "}}" TemplateName = "Usuário(a):SuggestBot/suggest" Pages = { "|" PageOrCategory } PageorCategory = PageTitle | CategoryTitle // PageTitle is the title of a page, e.g. "World War I" // CategoryTitle is the title of a category including "Category:", e.g. "Category:World War I"

Essa página descreve como utilizar o SuggestBot de forma a receber sugestões uma única vez. Adotamos um modelo de configuração visando não apenas a simplicidade do processo, mas também a automatização do envio de sugestões. Como explicitado a seguir, o nosso modelo também permite determinar em quais páginas as sugestões devem se basear. O SuggestBot remove automaticamente o modelo a medida que as sugestões são enviadas para você, garantindo assim que você receba cada sugestão apenas uma vez. Se você está interessado no SuggestBot e em seu funcionamento, por favor leia SuggestBot.

Como fazer para o SuggestBot enviar-lhe sugestões baseado no seu histórico:

• Pode obter sugestões baseadas nas páginas que você já editou, ou

• Obter sugestões baseadas em um conjunto específico de páginas.

Caso algo neste documento esteja confuso ou ainda necessite maiores esclarecidos, apreciaremos perguntas ou sugestões de melhorias em nossa página de discussão.

Sugestões baseadas em páginas que você já editou

Esse é o modo padrão de execução do SuggestBot. Primeiramente, ele recupera algumas centenas de edições mais recentemente realizadas por você e sugere novos artigos similares aos anteriormente editados e que ainda necessitam de melhorias. Para obter um conjunto de sugestões, adicione o seguinte código na sua página de discussão:

{{Usuário(a):SuggestBot/suggest}}

Você pode também adicionar esse modelo de código em qualquer subpágina de sua página principal na Wikipédia (e.g., "Usuário(a):Exemplo/Sugestões") e então as sugestões serão postadas lá, ao invés de enviadas para sua página de discussão. Periodicamente, atualizamos em nossos sistemas os usuários que adicionam o modelo de código. Assim, você pode obter sugestões rapidamente, dentre de quinze minutos apenas.

Sugestões baseadas em páginas específicas

Você pode informar ao SuggestBot exatamente quais páginas ele deve usar como base para suas sugestões, o que lhe oferece a oportunidade de, potencialmente, receber um conjunto de sugestões restritas a determinados interesses. Neste caso, o coletor desconsiderará suas edições recentes e, dessa forma, pode acabar sugerindo-lhe páginas que você editou recentemente. Entretanto, ele não sugerirá nenhum dos artigos especificados como base para as sugestões.

Por exemplo, suponha que você esteja interessado em Primeira Guerra Mundial e Segunda Guerra Mundial. A Wikipédia possui páginas específicas sobre tais assuntos e, consequentemente, podemos especificar para o SuggestBot utilizar essas páginas como base para as sugestões, listando-as em um modelo de código separado por "|", tal como:

{{Usuário(a):SuggestBot/suggest|Primeira Guerra Mundial|Segunda Guerra Mundial}}

Infelizmente, o SuggestBot não funciona adequadamente quando especificado um conjunto pequeno de páginas. Esse é o motivo pelo qual permitimos também especificar nomes de categorias de páginas na Wikipédia, as quais são automaticamente recuperadas pelo SuggestBot a partir do título e incorporadas ao conjunto de páginas base. Retornando ao exemplo prévio do World War I & II, podemos usar o fato que a Wikipédia também possui categorias sobre estes assuntos, (Categoria:Primeira Guerra Mundial e Categoria:Segunda Guerra Mundial), e informar ao SuggestBot para usar todos os artigos associados a essas categorias.

{{Usuário(a):SuggestBot/suggest|Categoria:Primeira Guerra Mundial|Categoria:Segunda Guerra Mundial}}

Dessa forma, o SuggestBot utilizará todas as 128 páginas relacionadas a pelo menos uma dessas categorias e emitirá sugestões baseado nessas páginas. É importante mencionar que a coleta não abrange as subcategorias. Dessa forma, é necessário explicitar todas as subcategorias de uma categoria que você possui interesse. Além disso, vale lembrar que é possível combinar páginas e categorias no modelo de código:

{{Usuário(a):SuggestBot/suggest|Primeira Guerra Mundial|Segunda Guerra Mundial|Categoria:Políticos da Segunda Guerra Mundial}}

Em suma, o modelo de código consiste do nome do modelo ("Usuário(a):SuggestBot/suggest"), seguido por uma sequência de "|" e título de uma página ou "|" e título de uma categoria. Definindo mais formalmente tal modelo usando o Extended Backus–Naur Form, o formato de código para uma "sugestão" é dado como segue:

    suggestion = "{{" TemplateName [ Pages ] "}}"
  TemplateName = "Usuário(a):SuggestBot/suggest"
         Pages = { "|" PageOrCategory }
PageorCategory = PageTitle | CategoryTitle
// PageTitle is the title of a page, e.g. "World War I"
// CategoryTitle is the title of a category including "Category:", e.g. "Category:World War I"