Lokalna kopia WordPress Codex?

44

Czasami chcę opracować motywy WordPress, gdy nie mam połączenia z Internetem. Potrzebuję odniesień do funkcji i tagów szablonów, aby były wydajne.

Szukałem do pobrania lub SVN kopii Kodeksu, ale nie mogłem go znaleźć. Skończyło się na tym wget, że próbowałem wykonać kopię lustrzaną , ale wyniki były niejednoznaczne (to zbyt duże!).

Czy jest lepszy sposób?

artlung
źródło
Uzyskaj iPada z dostępem 3G? ;-)
MikeSchinkel,

Odpowiedzi:

21

Używam znacznie szybszego i łatwiejszego sposobu na utworzenie lokalnej kopii kodeksu bez instalowania lokalnego serwera i bez instalowania kopii mediawiki, zwanej ScrapBook, która jest rozszerzeniem Firefoksa, która pomaga zapisywać strony internetowe i zarządzać kolekcją. Kluczowe cechy to lekkość, szybkość, dokładność i obsługa wielu języków.

za pomocą funkcji Zapisz stronę internetową (przechwytywanie dogłębne) możesz ustawić katalogi, które chcesz zapisać, co w Twoim przypadku byłoby Function ReferenceiTemplate Tags

wprowadź opis zdjęcia tutaj

możesz także organizować swoje kolekcje, podobnie jak zakładki, edytować zapisane pliki i wyróżniać kluczowe części stron, a najlepszą rzeczą jest wbudowane wyszukiwanie pełnotekstowe.

Bainternet
źródło
To jest całkiem świetne. Czy istnieje sposób, aby nakarmić go listą adresów URL do przechwycenia do późniejszego przejrzenia? I czy istnieje sposób, aby powiedzieć „idź odśwież tę listę adresów URL”?
artlung
Tak, a co do odświeżania nie jestem jeszcze pewien.
Bainternet,
Właśnie wypróbowałem i ma funkcję przechwytywania ponownie.
Bainternet,
Jest to świetny i lekki sposób szybkiego zapisywania dużej grupy plików. Miałem nadzieję na samowystarczalność, ale testowałem to, odkąd otworzyłem nagrodę i jest to najłatwiejszy najszybszy sposób na uzyskanie lokalnej kopii odpowiednich dokumentów.
artlung
1
Czy jest jakiś sposób przeszukiwania zapisanych stron?
45

Najlepiej założyć lokalną kopię MediaWiki. To jest to samo oprogramowanie, które obsługuje Wikipedię, ale jest to także aplikacja, która obsługuje Kodeks.

Po zainstalowaniu możesz nakazać Codexowi wyeksportowanie potrzebnych stron i zaimportować dokumenty XML do lokalnej instalacji. To nie jest zautomatyzowane, ale powinno dać ci wystarczającą ilość informacji do pracy w celu szybkiego odniesienia.

Uzyskaj MediaWiki

Cała dokumentacja dotycząca pobierania, instalowania i konfigurowania MediaWiki jest dostępna online .

Jeśli możesz uruchomić WordPress lokalnie, powinieneś być w stanie również uruchomić MediaWiki lokalnie (potrzebujesz PHP i MySQL, aby skonfigurować ustawienia).

Wyeksportuj kodeks

Zrób listę stron, które chcesz wyeksportować. Chciałbym, gdyby istniało zautomatyzowane narzędzie do eksportowania wszystkiego , ale w przypadku braku tego trzymajmy się procesu ręcznego.

Przejdź do http://codex.wordpress.org/Special:Export . Ta strona pozwala zaznaczyć strony i kategorie, które chcesz wyeksportować.

Powiedzmy, że chcesz po prostu wyeksportować Function Referencestronę. W dużym polu dla nazw stron wpisz „Function_Reference”. Umieść jedną nazwę strony w wierszu, aby wyeksportować wiele stron jednocześnie.

Ale ponieważ ta jedna strona nie jest zbyt przydatna ... Functionszamiast tego wyeksportuj całą kategorię. Wpisz „Funkcje” w polu kategorii i kliknij dodaj. Kodeks automatycznie wyświetli listę wszystkich stron funkcji 964. Następnie po prostu dodaj wiersz dla „Function_Reference”, aby uzyskać również indeks.

Kodeks ze wstępnie wybranymi stronami z odnośnikami funkcji

Możesz zobaczyć listę wszystkich dostępnych stron na http://codex.wordpress.org/Special:AllPages . Lista jest dość obszerna, więc jej tu nie omówię ... ale dodaj każdą stronę, którą chcesz wyeksportować, i kliknij.

Po kliknięciu „Eksportuj”, Kodeks wygeneruje (raczej duży) plik XML zawierający całą zawartość.

Zaimportuj kodeks

Teraz wróć do lokalnej instalacji MediaWiki. Możesz teraz zaimportować dokument XML i utworzyć lokalny „klon” Kodeksu WordPress.

Szczegółowe instrukcje importu są dostępne na stronie MediaWiki .

EAMann
źródło
4
Świetna odpowiedź! Właśnie zacząłem patrzeć na MediaWiki API i nawet nie zdawałem sobie sprawy, że Codex miał eksport.
Chris_O,
Niektóre strony zostały teraz przeniesione na developer.wordpress.org, co wyklucza je z kategorii Funkcje. Eksportowanie Functionsspowoduje brak stron (np. get_permalinkNie zostanie uwzględniony). Oszacuję, że brakuje około 20%.
Pim Schaaf,
9

Możesz używać aplikacji Dash (OS X) lub Zeal (Linux, Windows), które mają dostęp do funkcji Codex jako zestawu dokumentacji.

Jest łatwy w instalacji i obsłudze, choć trochę niewyraźny, jak aktualne są zestawy.

Rarst
źródło
3
Jestem programistą Dash. Aktualizuję zestaw WordPress za każdym razem, gdy wychodzi nowe wydanie WordPress.
bogdansrc
1
Czy jestem jedynym, który uważa, że ​​Zapał (lub Dash) jest wyjątkowo niedoceniany i ta odpowiedź powinna być teraz odpowiedzią akceptowaną ?
Ejaz,
@ Ejay zaakceptowaną odpowiedzią jest ta wybrana przez OP, ponieważ dla nich pracowała. :) To normalne, że wiele odpowiedzi oferuje różne podejście do pytania.
Rarst,
Dzięki Rarst. Niedawno przeprowadziłem migrację z Maca na Linuksa, a Zeal jest tym, czego szukałem. FWIW bogdansrc, kupiłem Dasha kilka razy na Macu, a ponieważ jesteś hojny w zestawach dokumentów, zawsze promuję go wśród programistów Mac. ;)
corysimmons
6

Myślę, że najlepszą rzeczą byłoby utworzenie raportu o błędzie i poproszenie fundacji WP o zainstalowanie tego rozszerzenia http://www.mediawiki.org/wiki/Extension:PdfBook Jeśli nic innego, zaznacz to do użytku prywatnego, a następnie podaj wygenerowany plik PDF dla użytkowników.

Ryan Gibbons
źródło
4

Zrobiłem to dla siebie za pomocą HTTrack (http://www.httrack.com/). Skończyło się to garstką megabajtów (teraz nie jestem pewien dokładnej liczby, straciłem lokalną kopię z powodu awarii dysku twardego i nie zadałem sobie trudu, aby ją odbudować), ale działało całkiem dobrze.

Keith S.
źródło
:-( Człowieku, musi być lepszy sposób. Dziękuję za odpowiedź. Mam nadzieję, że jest coś jeszcze!
artlung
czy jest coś takiego na Mac?
Łagodny Fuzz,
Istnieje aplikacja o nazwie BlueCrab, która robi coś podobnego, ale nie mogę z nią rozmawiać, ponieważ nigdy jej nie używałem.
Keith S.,
2

Możesz użyć MediaWiki API . Istnieje pełna dokumentacja na temat tworzenia kopii lustrzanej wiki za pomocą interfejsu API i innych metod.

Chris_O
źródło
Czy można zapisać w statycznym zestawie html, czy też muszę uruchomić Apache / PHP (lub cokolwiek inne aktualne wymagania MediaWiki) na urządzeniu docelowym? Szczegóły implementacji nie zawierają prostego zestawu instrukcji, zamiast tego wskazują inne rozwiązania na różnych etapach kompletności. sciencemedianetwork.org/wiki/…
artlung
Jeśli używasz go do lokalnego programowania WordPress, to już uruchomiłeś Apache / PHP i spełniasz wymagania, aby uruchomić MediaWiki lokalnie.
EAMann
@EAMann faktycznie znam kilku ludzi używających IIS, ale rozumiem twój punkt widzenia. Powiem jeszcze raz, że instrukcje powiązane z brakiem szczegółów. Nie utworzono „przepisu” do faktycznego uruchomienia kopii zapasowej.
artlung
Uruchomienie MediaWiki w IIS byłoby całkowicie osobnym problemem. Ale rozumiem twój punkt widzenia. Nawet na Windowsie po prostu zainstalowałbym XAMPP lub podobne rozwiązanie, aby uruchamiać rzeczy lokalnie.
EAMann
1

Fajny pomysł,

Jest kilka sposobów, aby uczynić go „lokalnym”.

  • Możesz zrobić na nim rekurencyjny wget. To zajmuje dużo czasu. Jak wspomniałeś.
  • Możesz użyć skrobaczki do ekranu: http://scraperwiki.com
  • Możesz napisać skrypt, który po prostu zapisuje go lokalnie przy każdym połączeniu z Internetem.
  • Możesz się zabrudzić i za każdym razem, gdy odwiedzasz kodeks, możesz po prostu zapisać go w folderze.

Krótko mówiąc, obecnie nie ma na to repozytorium. Chociaż zrobienie jednego byłoby fajne.

Może napiszę to ...


Wrócę później wieczorem. Mógłbym to zrobić za chwilę.

Umieszczę to na GitHub.

Aktualizacja: odpowiedź MediaWiki brzmi, jak należy to zrobić.

Sterling Hamilton
źródło
1

Wiem, że to stary wątek, ale zbiera on hity, więc dodam tę odpowiedź

devdocs.io ma wszystkie API dla WordPressa, których potrzebujesz, chociaż nie ma struktury takiej jak wersja Codex, w niektórych przypadkach jest nadal pomocna.

UWAGA: To nie tylko dokumenty WordPress, ale także wiele innych popularnych języków

tomexsans
źródło