Cópia local do WordPress Codex?

44

Às vezes, quero desenvolver temas do WordPress quando não tenho conexão com a internet. Preciso das Referência de Função e Tags de Modelo para serem produtivas.

Procurei uma cópia para download ou SVN do Codex, mas não consegui encontrar uma. Acabei tentando espelhá-lo usando wget, mas os resultados foram irregulares (é enorme demais!).

Existe uma maneira melhor?

documentation artlung
fonte
Adquira um iPad com acesso 3G? ;-)
MikeSchinkel

Respostas:

21

Use uma maneira muito mais rápida e fácil de criar uma cópia local do codex sem instalar um servidor local e sem instalar a cópia do mediawiki, chamada ScrapBook, que é uma extensão do Firefox, que ajuda a salvar páginas da Web e gerenciar a coleção. Os principais recursos são leveza, velocidade, precisão e suporte multilíngue.

usando o recurso Salvar site (Captura em profundidade), você pode definir os diretórios que deseja salvar, que no seu caso seriam Function ReferenceeTemplate Tags

insira a descrição da imagem aqui

você também pode organizar suas coleções como favoritos, editar arquivos salvos e destacar partes importantes das páginas, e a melhor coisa é a pesquisa de texto completa.

Bainternet
fonte
Isso é ótimo. Existe uma maneira de alimentar uma lista de URLs para capturar para visualização posterior? E existe uma maneira de dizer "vá atualizar esta lista de URLs"?
Artlung
Sim, e para refrescar ainda não tenho certeza.
Bainternet 13/03/12
Apenas tentei e ele tem um recurso de captura novamente.
Bainternet
Essa é uma ótima maneira leve de salvar rapidamente um grande grupo de arquivos. Eu esperava ser independente, mas testei isso desde que abri a recompensa e essa é a maneira mais rápida e fácil de obter uma cópia local dos documentos relevantes.
Artlung
1
Existe alguma maneira de pesquisar as páginas que você salvou?
45

Sua melhor aposta é configurar uma cópia local do MediaWiki. Este é o mesmo software que executa a Wikipedia, mas também é o aplicativo que alimenta o Codex.

Depois de instalá-lo, você pode dizer ao Codex para exportar as páginas que deseja e importar os documentos XML para a instalação local. Não é automatizado, mas deve fornecer informações suficientes para trabalhar com referências rápidas.

Obtenha o MediaWiki

Toda a documentação para baixar, instalar e configurar o MediaWiki está disponível online .

Se você pode executar o WordPress localmente, também poderá executar o MediaWiki localmente (você precisa de PHP e MySQL para configurar as coisas).

Exportar o Codex

Faça uma lista das páginas que você deseja exportar. Eu adoraria se houvesse uma ferramenta automatizada para exportar tudo , mas, na ausência disso, vamos continuar com o processo manual.

Navegue para http://codex.wordpress.org/ Especial: exportação . Esta página permite marcar quais páginas e categorias você deseja exportar.

Digamos que você queira apenas exportar a Function Referencepágina. Você digitaria "Function_Reference" na caixa grande para nomes de páginas. Coloque um nome de página por linha para exportar várias páginas ao mesmo tempo.

Mas como essa página não é muito útil ... exporte a Functionscategoria inteira . Digite "Funções" na caixa de categoria e clique em adicionar. O Codex listará automaticamente todas as 964 páginas de funções para você. Em seguida, basta adicionar uma linha para "Function_Reference" para obter o índice também.

Codex com páginas de referência de função pré-selecionadas

Você pode ver uma lista de todas as páginas disponíveis em http://codex.wordpress.org/Special:AllPages . A lista é bastante extensa, por isso não a abordarei aqui ... mas adicione todas as páginas que você deseja exportar e clique em.

Depois de clicar em "Exportar", o Codex gerará um arquivo XML (bastante grande) contendo todo o conteúdo.

Importar o Codex

Agora volte para a instalação local do MediaWiki. Agora você pode importar o documento XML e criar seu "clone" local do Codex do WordPress.

Instruções detalhadas de importação estão disponíveis no site do MediaWiki .

EAMann
fonte
4
Ótima resposta! Comecei a olhar para a API MediaWiki e nem percebi que o Codex tinha uma exportação.
22412 Chris_O
Agora, algumas páginas foram transferidas para developer.wordpress.org, que as exclui da categoria Funções. A exportação do Functionsresultado resultará em páginas ausentes (por exemplo get_permalink, não serão incluídas). Eu estimaria que cerca de 20% está faltando.
Pim Schaaf
9

É possível usar os aplicativos Dash (OS X) ou Zeal (Linux, Windows) que possuem a referência de função Codex disponível como conjunto de documentação.

É fácil de instalar e usar, no entanto, um pouco confuso quanto à atualização dos aparelhos.

Rarst
fonte
3
Sou o desenvolvedor do Dash. Eu atualizo o docset do WordPress sempre que uma nova versão do WordPress é lançada.
bogdansrc
1
Eu sou o único que acha que Zelo (ou Dash) é extremamente subestimado e essa resposta deve ser a resposta aceita agora ?
Ejaz
@ Ejay, a resposta aceita é a escolhida pelo OP, como funcionou para eles. :) É normal que várias respostas ofereçam diferentes abordagens à pergunta.
Rarst
Obrigado Rarst. Migrou do Mac para o Linux recentemente e o Zeal é exatamente o que eu estava procurando. FWIW bogdansrc, comprei o Dash algumas vezes no Mac e, como você está sendo generoso com os documentos, sempre o promoverei para os desenvolvedores do Mac. ;)
corysimmons
6

Acho que o melhor seria criar um relatório de erro e solicitar à fundação WP que instale esta extensão http://www.mediawiki.org/wiki/Extension:PdfBook Se nada mais, marque-o para uso privado e forneça o PDF gerado para os usuários.

Ryan Gibbons
fonte
4

Fiz isso sozinho usando o HTTrack (http://www.httrack.com/). Acabou sendo um punhado de megabytes (não tenho certeza do número exato agora, perdi minha cópia local devido a uma falha no disco rígido e não me preocupei em reconstruí-la ainda), mas funcionou muito bem.

Keith S.
fonte
:-( Man, tem que haver uma maneira melhor Obrigado pela resposta embora Esperemos que há algo mais..!
artlung
existe algo assim para mac?
Mild Fuzz
Existe um aplicativo chamado BlueCrab que faz algo semelhante, mas não posso falar sobre o uso, pois nunca o usei.
12338 Keith S.
2

Você pode usar a API MediaWiki . Existe uma documentação completa sobre como espelhar um wiki usando a API e outros métodos.

Chris_O
fonte
É possível armazenar em um conjunto estático de html ou preciso estar executando o Apache / PHP (ou quaisquer que sejam os requisitos atuais do MediaWiki) no dispositivo de destino? Os detalhes da implementação não possuem um conjunto simples de instruções; eles apontam para outras soluções em vários estágios de completude. sciencemedianetwork.org/wiki/…
artlung
Se você o estiver usando para desenvolver o WordPress localmente, já estará executando o Apache / PHP e atenda aos requisitos para executar o MediaWiki localmente.
EAMann
@EAMann, na verdade, conheço algumas pessoas que usam o IIS, mas eu entendo o seu ponto. Eu direi novamente que as instruções vinculadas à falta de detalhes. Não há "receita" criada para realmente executar o backup.
Artlung
A execução do MediaWiki no IIS seria um problema completamente separado. Mas entendo o seu ponto. Mesmo em uma caixa do Windows, eu instalava o XAMPP ou uma solução semelhante para executar as coisas localmente.
EAMann
1

Ideia legal,

Existem algumas maneiras de torná-lo "local".

  • Você poderia fazer um trabalho recursivo nele. Isso leva muito tempo. Como você mencionou.
  • Você pode usar um raspador de tela: http://scraperwiki.com
  • Você pode escrever um script que o salve localmente toda vez que se conectar à Internet.
  • Você pode ficar sujo e toda vez que visitar o códice, poderá salvá-lo em uma pasta.

Em suma, não há repositório para isso no momento. Embora fazer um seria legal.

Talvez eu escreva isso ...

Vou postar de volta mais tarde esta noite. Na verdade, posso fazer isso daqui a pouco.

Vou colocar no GitHub.

Atualização: A resposta do MediaWiki é como isso realmente deve ser feito.

Sterling Hamilton
fonte
1

Eu sei que este é um tópico antigo, mas está reunindo hits, então eu adicionarei esta resposta

O devdocs.io possui todas as APIs para WordPress que você precisa, embora não seja estruturado como a versão do Codex, ainda é útil em alguns casos.

NOTA: Não são apenas documentos do WordPress, mas também muitos outros idiomas populares

tomexsans
fonte