Perintah WP-CLI

Perintah wp gitdocs untuk menyiapkan, memelihara, dan memeriksa situs dokumentasi.

Di halaman ini

GitDocs mendaftarkan perintah wp gitdocs ketika WP-CLI tersedia.

Bash

wp gitdocs <perintah>

info

Menampilkan ringkasan space, jumlah halaman, dan URL penting.

Terminal

$ wp gitdocs info
+----+---------------+---------+-----------+-------+------------------------------------------+
| id | space         | slug    | published | total | url                                      |
+----+---------------+---------+-----------+-------+------------------------------------------+
| 2  | Panduan       | panduan | 16        | 17    | https://situs.id/docs/panduan/           |
| 3  | Referensi API | api     | 7         | 7     | https://situs.id/docs/api/               |
+----+---------------+---------+-----------+-------+------------------------------------------+
Beranda dokumentasi: https://situs.id/docs/
Indeks pencarian:    https://situs.id/wp-content/uploads/gitdocs/search-index.json?v=8f3a1c9e2b40

seed

Mengimpor konten contoh berbahasa Indonesia. Aman dijalankan ulang: halaman yang sudah ada (space + induk + slug yang sama) dilewati, dan gambar hanya diimpor sekali.

Bash

wp gitdocs seed

rerender

Merender ulang HTML setiap halaman dari sumber Markdown-nya. Jalankan setelah memperbarui tema atau mengubah komponen.

Bash

wp gitdocs rerender

rerender tidak membuat revisi baru dan tidak mengubah tanggal "Diperbarui pada" — ini pemeliharaan struktural, bukan penyuntingan.

reindex

Membangun ulang berkas indeks pencarian.

Bash

wp gitdocs reindex

Resep yang berguna

Impor berkas Markdown massal

Bash

#!/usr/bin/env bash
# Mengimpor seluruh berkas .md dalam sebuah folder ke space tertentu.
SPACE=2

for file in docs/*.md; do
  title="$(basename "${file%.md}" | tr '-' ' ')"
  wp eval "
    \$id = GitDocs\\Pages::create( array(
      'space'    => $SPACE,
      'title'    => '$title',
      'markdown' => file_get_contents( '$file' ),
      'status'   => 'publish',
    ), true );
    echo is_wp_error( \$id ) ? \$id->get_error_message() : \"OK \$id\n\";
  "
done

Ekspor seluruh halaman menjadi Markdown

Bash

wp eval '
foreach ( get_posts( array( "post_type" => "doc_page", "posts_per_page" => -1, "post_status" => "publish" ) ) as $page ) {
    $path = "ekspor/" . $page->post_name . ".md";
    @mkdir( "ekspor" );
    file_put_contents( $path, "---\ntitle: {$page->post_title}\n---\n\n" . get_post_meta( $page->ID, "gitdocs_markdown", true ) );
    WP_CLI::log( $path );
}'

Periksa halaman tanpa deskripsi

Bash

wp eval '
foreach ( get_posts( array( "post_type" => "doc_page", "posts_per_page" => -1 ) ) as $page ) {
    if ( "" === trim( $page->post_excerpt ) ) {
        WP_CLI::log( sprintf( "%-6d %s", $page->ID, $page->post_title ) );
    }
}'

Segarkan aturan URL

Bash

wp rewrite flush

Jalankan bila URL dokumentasi mendadak menghasilkan 404 setelah mengubah basis URL atau slug space lewat SQL langsung.

Semua perintah di atas juga tersedia sebagai tombol di Dokumentasi → Alat & Pengaturan untuk situs yang tidak memiliki akses WP-CLI.