Pengguna:HsfBot/Arsip otomatis

Menyiapkan pengarsipan

Letakkan templat berikut di bagian paling atas halaman yang ingin Anda arsipkan secara otomatis:

{{User:HsfBot/config
| algo    = old(...)
| archive = Nama halaman arsip: Untuk menghasilkan beberapa halaman dari waktu ke waktu, gunakan variabel, yang dijelaskan di bawah ini.
[parameter lain - ***baca di bawah ini***]
}}

Bot hanya mengenali satu parameter per baris. Penutupan }} harus berada pada baris tersendiri. Tidak boleh ada spasi sebelum pipa ( | ). Jika Anda menambahkan parameter baru, selalu mulai pada baris baru, bot tidak akan bekerja jika anda meringkas pemanggilan templat menjadi satu baris.

Selain itu, templat harus ditempatkan:

1. sebelum header == tingkat kedua == pertama di halaman
2. pada halaman sebenarnya yang hendak diarsipkan, dan tidak ditransklusikan dari subhalaman, seperti header halaman, templat, dll.

Contoh singkat

Konfigurasi sederhana, mungkin tidak intuitif, tapi fleksibel dan praktis.

Silahkan ganti "Pembicaraan pengguna:Contoh" ke nama sebenarnya dari halaman Anda sendiri!

Jika masih tidak berfungsi, baca tentang parameter minthreadsleft dan minthreadstoarchive di bawah ini.

Contoh 1: arsip statis

{{User:HsfBot/config
| algo    = old(7d)
| archive = Pembicaraan pengguna:Contoh/Arsip
}}

Pengaturan ini mengarsipkan untai/thread dari Pembicaraan pengguna:Contoh ke Pembicaraan pengguna:Contoh/Arsip setelah berumur 7 hari (terhitung dari cap waktu terbaru). Arsip akan membeku saat ukuran halaman mencapai 2000 KB . Mungkin bukan konfigurasi yang sangat berguna (kecuali untuk mengirim thread ke tempat sampah [halaman yang dibersihkan secara berkala] atau untuk menentukan secara manual kapan Anda harus beralih ke halaman arsip berikutnya).

Contoh 2: Arsip berkesinambungan

{{User:HsfBot/config
| algo                = old(30d)
| archive             = Pembicaraan pengguna:Contoh/Arsip %(counter)d
| counter             = 1
| maxarchivesize      = 150K
| archiveheader       = {{Automatic archive navigator}}
| minthreadstoarchive = 1
| minthreadsleft      = 4
}}

salin dan tempel agar mudah digunakan

{{User:HsfBot/config
| algo                = old(30d)
| archive             = {{SUBST:FULLPAGENAME}}/Arsip %(counter)d
| counter             = 1
| maxarchivesize      = 150K
| archiveheader       = {{Automatic archive navigator}}
| minthreadstoarchive = 1
| minthreadsleft      = 4
}}

Ini memberitahu bot untuk mengarsipkan thread lebih dari tiga puluh hari (dengan meninggalkan 4 terakhir yang tersisa) dari Pembicaraan pengguna: Contoh ke Pembicaraan pengguna:Contoh/Arsip 1 (lebih lanjut tentang variabel lihat dibawah) mengisi halaman arsip sampai 150 kilobita, lalu bot akan berpindah ke subhalaman /Arsip 2 (memperbarui templat saat menyimpan halaman). Ingatlah untuk menentukan ukuran maksimum arsip, atau arsip akan menumpuk (ukuran halaman arsip tidak terdistribusi secara merata) seperti pada contoh pertama. Selain itu, setiap halaman arsip diberi banner {{Aan}}, yang memudahkan untuk berpindah di antara halaman arsip yang berbeda.

Contoh 3: arsip berbasis tanggal

{{User:HsfBot/config
| algo          = old(5d)
| archive       = Pembicaraan pengguna:Contoh/Arsip/%(year)d/%(monthname)s
| archiveheader = {{MonthlyArchive}}
}}

salin dan tempel untuk memudahkan

{{User:HsfBot/config
| algo          = old(5d)
| archive       = {{SUBST:FULLPAGENAME}}/%(year)d/%(monthname)s
| archiveheader = {{MonthlyArchive}}
}}

Dalam konfigurasi ini, topik yang lebih tua dari 5 hari akan dimasukan di arsip tergantung tanggalnya (yaitu cap waktu terbaru). Anda bisa membaca tentang variabel lain dibawah ini.

Penjelasan parameter

{{User:HsfBot/config 
| archive             = 
| algo                = 
| counter             = 
| maxarchivesize      = 
| minthreadsleft      = 
| minthreadstoarchive = 
| archiveheader       = 
| key                 = 
}}

Parameter	Baku	Deskripsi
archive	N/A; diperlukan	Nama halaman dimana thread yang akan diarsipkan disimpan. Parameter ini mendukung penggunaan variabel, yang bisa digunakan untuk membuat nama arsip dinamis (misalnya menggunakan jangakauan tanggal/waktu tertentu). Perhatikan bahwa kata magis dan templat tidak bekerja dengan parameter ini, dan kecuali sebuah kunci (key) tambahan diberikan (lihat dibawah), halaman target haruslah subhalaman dari halaman yang akan diarsipkan.
algo	old(24h)	Algoritma yang menginstruksikan bot bagaimana memutuskan apakah akan mengarsipkan thread atau tidak. Rumus kompleks (termasuk pencocokan regex) akan tersedia di masa depan, tapi sejauh ini harus dari bentuk old(...)</ kbd> di mana ...menentukan usia maksimum thread (dalam jam atau hari dalam bahasa Inggris:24h,72h,5d,21d, dll.).
counter	1	Jumlah arsip terakhir saat ini. Jika variabel %(counter)d tidak digunakan, maka diabaikan. HsfBot akan memperbarui parameter ini seperlunya.
maxarchivesize	1954K	Ukuran arsip maksimum dalam ukuran teks mentah (misalnya 256M untuk megabyte, 256K untuk kilobyte, atau 256B untuk byte) atau benang (misalnya 10T) sebelum menambahkan penghitung. Sebuah bilangan bulat telanjang akan diartikan sebagai byte. Diabaikan jika counter tidak digunakan.
minthreadsleft	5	Jumlah minimum benang yang harus ditinggalkan di halaman (untuk mencegah agar halaman tidak dipanen sepenuhnya).
minthreadstoarchive	2	Jumlah minimum thread untuk diarsipkan pada satu waktu, yang digunakan untuk menurunkan frekuensi edit. HsfBot tidak akan mengarsipkan thread bila kurang dari nilai parameter ini yang akan diarsipkan.
archiveheader	{{Talk archive}}	Konten yang akan diletakkan di halaman arsip baru sebagai header. Parameter ini mendukung penggunaan variabel.
key		Kunci rahasia yang (jika berlaku) memungkinkan arsip untuk bukan menjadi subhalaman dari halaman yang sedang diarsipkan.

Variabel

Parameter variabel	Keterangan...
%(counter)d	Nilai terkini dari counter
%(year)d	Tahun dari thread yang diarsipkan (2017, 2018, dst.)
%(month)d	Bulan (sebagai nomor 1-12) dari thread yang diarsipkan
%(monthname)s	Nama bahasa Inggris dari nomor bulan di atas
%(monthnameshort)s	Tiga huruf pertama dari nama bulan diatas

Menunda atau mencegah pengarsipan thread tertentu

Pengarsipan dapat ditunda untuk thread tertentu dengan menambahkan templat {{DNAU}} ke dalam thread/topik. Gunakan {{subst:DNAU}} untuk menyimpan untaian tanpa batas waktu, atau {{subst:DNAU|<integer>}} untuk mencegah pengarsipan thread selama <integer> hari. lihat dokumentasi templat untuk rincian tentang penggunaan dan fungsinya.