Blok Kode

Penyorotan sintaks, judul berkas, nomor baris, pembungkus baris, dan tombol salin.

Di halaman ini

Blok kode memakai Prism.js yang disertakan langsung di tema (lebih dari lima puluh bahasa) — tidak ada permintaan ke CDN mana pun.

Dasar

PHP

<?php
/**
 * Menambahkan tautan "Edit di repositori" pada setiap halaman.
 */
add_filter( 'gitdocs_external_edit_url', function ( string $url, WP_Post $post ): string {
    return "https://github.com/org/repo/edit/main/docs/{$post->post_name}.md";
}, 10, 2 );

Sintaksnya:

Markdown

```php
<?php
echo 'Halo dunia';
```

Judul berkas

Tambahkan title agar pembaca tahu berkas mana yang diubah.

terminalBash

wp gitdocs reindex

Markdown

```bash title="terminal"
wp gitdocs reindex
```

Nomor baris dan pembungkus

app.jsJavaScript

const config = JSON.parse( document.getElementById( 'gitdocs-config' ).textContent );
const results = index.search( query, { limit: 60 } );

results.forEach( ( hit ) => {
    render( hit.item );
} );

Gunakan lineNumbers untuk menomori baris dan wrap agar baris panjang dibungkus, bukan digulir:

Markdown

```js title="app.js" lineNumbers wrap
// …
```

Sintaks GitBook juga dikenali:

Markdown

{% code title="app.js" lineNumbers="true" overflow="wrap" %}
```js
// …
```
{% endcode %}

Beberapa bahasa

Terminal

$ wp gitdocs info
+----+----------+---------+-----------+
| id | space    | slug    | published |
+----+----------+---------+-----------+
| 2  | Panduan  | panduan | 16        |
+----+----------+---------+-----------+

JSON

{
    "space": 2,
    "items": [
        { "id": 12, "parent": 0, "order": 1 },
        { "id": 18, "parent": 12, "order": 1 }
    ]
}

SQL

SELECT p.ID, p.post_title
FROM wp_posts p
WHERE p.post_type = 'doc_page' AND p.post_status = 'publish'
ORDER BY p.menu_order ASC;

Diff

- --gd-accent: #2563eb;
+ --gd-accent: #0ea5e9;

Nama bahasa

Alias umum diterjemahkan otomatis: js, ts, sh, console, yml, md, dockerfile, c++, c#, env, dan lainnya. Bahasa yang tidak dikenali tetap ditampilkan rapi, hanya tanpa pewarnaan.

Ditulis	Label	Penyorotan
`js`	JavaScript	ya
`console`	Terminal	ya
`text`	Teks	tidak
`mermaid`	—	dirender sebagai diagram
`math`	—	dirender sebagai rumus

Tombol Salin ditambahkan otomatis pada setiap blok kode, dan penyorotan hanya dimuat ketika halaman benar-benar memuat kode — halaman tanpa kode tidak menanggung beban JavaScript-nya.

Kode sebaris

Gunakan satu backtick untuk nama_fungsi(), nama berkas seperti functions.php, atau nilai seperti --gd-accent.

Tanda kurung siku di dalam kode ditulis sebagai entitas HTML saat disimpan, sehingga contoh shortcode seperti [gallery] ditampilkan apa adanya, bukan dieksekusi WordPress.