Pengguna:HsfBot/Arsip otomatis: Perbedaan antara revisi
Konten dihapus Konten ditambahkan
Hidayatsrf (bicara | kontrib) Tidak ada ringkasan suntingan |
Hidayatsrf (bicara | kontrib) →Contoh 3: arsip berbasis tanggal: // Edit via Wikiplus |
||
| (34 revisi perantara oleh 2 pengguna tidak ditampilkan) | |||
Baris 1:
{{Notice|Halaman instruksi ini didasarkan pada [[:en:User:Lowercase sigmabot III/Archive HowTo]].}}
<!--
: (For similar bots, see [[:Category:Wikipedia archive bots]].)
-->
{{Warning|Kekutu: untuk saat ini HsfBot hanya bisa mengarsipkan ''thread'' atau bagian halaman pembicaraan yang ditandangani dalam [[UTC]]. Halaman yang ditandatangani dalam waktu lokal kemungkinan harus diarsipkan secara manual}}
{{Warning|Sebelum menyiapkan pengarsipan otomatis di halaman pembicaraan artikel, mohon buat konsensus bahwa pengarsipan benar-benar dibutuhkan di sana.}}
=== Menyiapkan pengarsipan ===
Letakkan templat berikut di bagian paling atas halaman yang ingin Anda arsipkan secara otomatis:
{{Warning|Kode di bawah tidak akan bekerja, lihat contoh untuk mengisi opsi yang sesuai}}
<pre style="overflow: auto">
{{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***]
}}
<!--
Well, maybe '''not exactly''' that (read about required options below), but that's how it's done. By the way, [[User:HsfBot/config|the template]] has '''no content''' and is sysop-'''protected''', so don't worry about visual appearance. :)
-->
Bot hanya mengenali satu parameter per baris. Penutupan <code>}}</code> harus berada pada baris tersendiri. Tidak boleh ada spasi sebelum pipa ( <code>|</code> ). 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:
# sebelum header <code>== tingkat kedua ==</code> ''pertama'' di halaman
# 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.
:<span style="color:darkred;">'''Silahkan ganti "''Pembicaraan pengguna:Contoh''" ke nama ''sebenarnya'' dari halaman Anda sendiri!'''</span>
:<span style="color:darkgreen;">'''Jika masih tidak berfungsi, baca tentang parameter ''minthreadsleft'' dan ''minthreadstoarchive'' di bawah ini.'''</span>
==== Contoh 1: arsip statis ====
{{Warning|Paling sederhana, ini mungkin bukan pilihan terbaik - contoh kedua lebih sering digunakan.}}
<pre style="overflow: auto">
{{User:HsfBot/config
| algo = old(7d)
| archive = Pembicaraan pengguna:Contoh/Arsip
}}
</pre>
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 ====
<pre style="overflow: auto">
{{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
}}
</pre>
{{Hst|reason=salin dan tempel agar mudah digunakan}}
<pre style="overflow: auto">
{{User:HsfBot/config
| algo = old(30d)
| archive = {{SUBST:FULLPAGENAME}}/Arsip %(counter)d
| counter = 1
| maxarchivesize = 150K
| archiveheader = {{Automatic archive navigator}}
| minthreadstoarchive = 1
| minthreadsleft = 4
}}
</pre>
{{Hsb}}
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 [[#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 {{Tl|Aan}}, yang memudahkan untuk berpindah di antara halaman arsip yang berbeda.
==== Contoh 3: arsip berbasis tanggal ====
{{Warning|'''Jangan''' mengganti '''"year"''' dan "'''monthname"''' dengan nilai sebenarnya - bot akan memperlakukannya sebagai variabel yang sesuai.}}
<pre style="overflow: auto">
{{User:HsfBot/config
| algo = old(5d)
| archive = Pembicaraan pengguna:Contoh/Arsip/%(year)d/%(monthname)s
| archiveheader = {{MonthlyArchive}}
}}
</pre>
{{Hst|reason=Salin dan tempel untuk memudahkan}}
<pre style="overflow: auto">
{{User:HsfBot/config
| algo = old(5d)
| archive = {{SUBST:FULLPAGENAME}}/%(year)d/%(monthname)s
| archiveheader = {{MonthlyArchive}}
}}
</pre>
{{Hsb}}
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 [[#Variable|dibawah ini]].
=== Penjelasan parameter ===
<pre>
{{User:HsfBot/config
| archive =
| algo =
| counter =
| maxarchivesize =
| minthreadsleft =
| minthreadstoarchive =
| archiveheader =
| key =
}}
</pre>
{| class = "wikitable"
! Parameter || Baku || Deskripsi
|-
| <kbd>archive</kbd> || N/A; diperlukan || Nama halaman dimana thread yang akan diarsipkan disimpan. Parameter ini mendukung penggunaan [[#Variabel|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 (<kbd>key</kbd>) tambahan diberikan (lihat dibawah), halaman target haruslah subhalaman dari halaman yang akan diarsipkan.
|-
| <kbd>algo</kbd> || <kbd>old(24h)</kbd> || 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 '''<kbd>old(...)</ kbd>''' di mana '''...'''menentukan usia maksimum thread (dalam jam atau hari dalam bahasa Inggris:''24h'',''72h'',''5d'',''21d'', dll.).
|-
| <kbd>counter</kbd> || <kbd>1</kbd> || Jumlah arsip terakhir saat ini. Jika variabel <kbd>%(counter)d</kbd> tidak digunakan, maka diabaikan. HsfBot akan memperbarui parameter ini seperlunya.
|-
| <kbd>maxarchivesize</kbd> || <kbd>1954K</kbd> || Ukuran arsip maksimum dalam ukuran teks mentah (misalnya <kbd> 256M </kbd> untuk megabyte, <kbd>256K</kbd> untuk kilobyte, atau <kbd>256B</kbd> untuk byte) atau benang (misalnya <kbd>10T</kbd>) sebelum menambahkan penghitung. Sebuah bilangan bulat telanjang akan diartikan sebagai byte. Diabaikan jika counter tidak digunakan.
|-
| <kbd>minthreadsleft</kbd> || <kbd>5</kbd> || Jumlah minimum benang yang harus ditinggalkan di halaman (untuk mencegah agar halaman tidak dipanen sepenuhnya).
|-
| <kbd>minthreadstoarchive</kbd> || <kbd>2</kbd> || 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.
|-
| <kbd>archiveheader</kbd> || <kbd>{{Tl|Talk archive}}</kbd> || Konten yang akan diletakkan di halaman arsip baru sebagai header. Parameter ini mendukung penggunaan [[#Variabel|variabel]].
|-
| <kbd>key</kbd> || || Kunci rahasia yang (jika berlaku) memungkinkan arsip untuk '' bukan'' menjadi subhalaman dari halaman yang sedang diarsipkan.<!-- Untuk mendapatkan kunci seperti itu, [[Pembicaraan pengguna: Σ | minta dari & nbsp; editor & nbsp;] ini], dan sebaiknya Anda memiliki '' justifikasi yang bagus untuk melakukannya.-->
|}
=== Variabel ===
{| class = "wikitable"
! Parameter variabel || Keterangan...
|-
| <kbd>%(counter)d</kbd> || Nilai terkini dari <kbd>counter</kbd>
|-
| <kbd>%(year)d</kbd> || Tahun dari thread yang diarsipkan (2017, 2018, dst.)
|-
| <kbd>%(month)d</kbd> || Bulan (sebagai nomor 1-12) dari thread yang diarsipkan
|-
| <kbd>%(monthname)s</kbd> || Nama bahasa Inggris dari nomor bulan di atas
|-
| <kbd>%(monthnameshort)s</kbd> || Tiga huruf pertama dari nama bulan diatas
|}
<!--
Those [[python (programming language)|python]]-savvy people will immediately recognize these variables are filled at runtime with the <kbd>%</kbd> operator and should know how to adjust the format. A few points of interest to others:
*make sure you don't mess up the last letter after the brackets (it's "d" for [[integer]]s and "s" for [[string (computer science)|strings]])
*integer variables may be left-padded with zeros:
*:<kbd>%(counter)03d</kbd> evaluates to <kbd>013</kbd> if the <kbd>counter</kbd>'s value equals 13,
*:<kbd>%(month)02d</kbd> becomes <kbd>05</kbd> for May etc.
-->
=== Setelah mengatur pengarsipan ===
<!--
The bot runs once a day at a preset hour, or twice a day for [[WP:Administrators' Noticeboard|WP:AN]] and [[Wikipedia:Administrators' noticeboard/Incidents|WP:AN/I]]. Simply wait for the next cycle and you should see the bot's entries in the history list of your article '''providing''' there was anything to archive, and the history list entry should provide a link to the archive page you specified.<br />
Various [[WP:TM|templates]] will produce an automatic list of archive subpages. Typically, such a template will be added to the top-level talk page to make archives easier to find. Simply add the template name in <code><nowiki>{{curly-braces}}</nowiki></code> where you want it to appear. Popular templates used for this purpose include:
* {{Tlx|Automatic archive navigator}}
* {{Tlx|Archive box}}
* {{Tlx|archives}}
* {{Tlx|MonthlyArchive}}. If you use [[#Example 3 - date-based archives]], use this with <code>root = Pembicaraan pengguna:Example/Archives</code>.
* {{Tlx|Talk header}} (this template has other functions, but can include a list of archives and a search box)
-->
=== Menunda atau mencegah pengarsipan thread tertentu ===
Pengarsipan dapat ditunda untuk thread tertentu dengan menambahkan templat {{tl|DNAU}} ke dalam thread/topik. Gunakan <code><nowiki>{{subst:DNAU}}</nowiki></code> untuk menyimpan untaian tanpa batas waktu, atau <code> <nowiki>{{subst:DNAU|<integer>}}</nowiki></code> untuk mencegah pengarsipan thread selama <[[integer]]> hari. lihat dokumentasi templat untuk rincian tentang penggunaan dan fungsinya.
=== Halaman yang menggunakan fitur ini ===
Berikut daftar halaman yang menggunakan fitur ini: (diperbarui bot dari [[Pengguna:HsfBot/config/report]])
{{Pengguna:HsfBot/config/report}}
{{Warchivenav|state=uncollapsed}}
<noinclude>
</noinclude>
[[en:User:Lowercase sigmabot III/Archive HowTo]]
[[fi:Käyttäjä:HarrivBOT/config]]
| |||