Ini adalah database URL mnemonik, pengalihan, dan mesin pencari.
Fungsi utama alat ini adalah HTTP mengarahkan pengguna langsung ke URL yang terkait dengan kata kunci yang mereka akses. URL sulit diingat dan diketik, namun lebih mudah digunakan jika diberi nama secara ringkas. Tautan diberi nama atau ditandai dan ditempatkan ke dalam daftar yang diidentifikasi berdasarkan kata kunci . Kata kunci ini adalah string intuitif dan terkenal yang dibuat oleh pengguna untuk menggambarkan daftar atau tautan yang dicari.
Fungsi sekundernya adalah menyediakan tempat untuk menyusun daftar tautan terkini ke subjek tertentu.
Jika pengguna ingin mencari informasi tentang Mars, mereka dapat mengetik go2 mars
di URL/bilah pencarian browser mereka. Ini bisa mengarahkan langsung ke link atau daftar link tentang planet ini. Bayangkan ada beberapa link atau artikel tentang Mars yang ada di daftar ini. Bagaimana pengguna bisa mendapatkan lebih banyak informasi tentang bulan Phobos, langsung mengunjunginya dalam satu pencarian? Kurator daftar dapat menandai salah satu tautan dalam daftar dengan phobos
. Sekarang pengguna dapat mengetik go2 mars/phobos
di URL/bilah pencarian mereka. Tautan tersebut kini telah menjadi pengalihan kanonik bagi siapa pun yang mencari informasi lebih lanjut tentang bulan Mars ini.
Pengalih go2 mengikuti model penambahan, penghapusan, dan kurasi data berbasis komunitas seperti Wikipedia. Jika pengguna secara kolektif menyetujui arti kata kunci dan pada gilirannya menyetujui daftar kata kunci tersebut, hasilnya adalah pemahaman grup yang paling akurat tentang kata kunci mnemonik ini pada saat tertentu. Semakin banyak orang yang menggunakan pengalihan, semakin banyak editor yang selalu memperbarui semuanya.
Untuk menyiapkan aplikasi, konfigurasi awal dan database tautan kosong perlu dibuat. Untuk melakukan ini, jalankan skrip instalasi dari baris perintah.
./install.sh
Ini akan menempatkan file godb.json
pada disk di direktori root proyek, kemudian akan menulis file konfigurasi generik go2config.json
di direktori yang sama. Pengaturan default di file konfigurasi sudah cukup untuk memulai, tetapi lihatlah untuk memahami pengaturan yang tersedia.
Redirector perlu dikompilasi sebagai langkah penyiapan kedua dan terakhir. go build
sederhana di root proyek akan menghasilkan file yang dapat dieksekusi. Jalankan executable tersebut tanpa argumen untuk melihat redirector mulai, mendengarkan pada port sementara.
Dockerfile
multi-tahap disertakan di sini untuk memudahkan proses pembuatan biner dan menyediakan container yang dapat dijalankan. Kontainer bangunan awal sangat besar dan dibuang demi kontainer runtime berbasis linux alpine yang lebih kecil. Ada tiga elemen untuk membangun dan menjalankan kontainer: membangun, mempertahankan database tautan, dan menjalankan kontainer.
Membangun container dapat dilakukan dengan: docker build -t go2redirector .
Jika Anda ingin memeriksa kontainer build itu sendiri untuk memeriksa/men-debug lingkungan build, Anda dapat mengaksesnya dengan menargetkan kontainer build berdasarkan nama.
docker build --target builder -t go2build .
Anda dapat membuat volume secara lokal untuk ruang persisten di luar wadah untuk godb.json
. Ini akan memungkinkan penampung Anda menggunakan godb yang sama setiap kali dijalankan. Tinggalkan prosedur ini jika Anda tidak ingin menyimpan database di antara penampung yang dijalankan.
docker volume create go2
docker volume inspect go2
Sekarang jalankan containernya, menggunakan volume. Ini akan menjalankan container dalam mode daemon dan menghapusnya saat berhenti.
docker run --rm -p 8080:8080 -d -v go2:/home/gouser/data go2redirector
Perhatikan bahwa Anda tidak perlu menggunakan volume seperti ini. Pengikatan pengikatan ke direktori lain yang sudah ada juga akan berfungsi.
Redirector akan mendengarkan 0.0.0.0:8080
di dalam container, berbeda dengan default 127.0.0.1
dari go2config.json (default).
Untuk melihat log dari container, semuanya dialihkan ke stdout, sehingga Anda dapat melakukan docker logs <name of running container>
Go2redirector seharusnya berjalan di localhost:8080
sekarang. Anda dapat melakukannya langsung, atau untuk mempermudah, Anda dapat mengkonfigurasi browser Anda dengan kata kunci pencarian baru seperti go2
.
Setiap browser memiliki prosedur konfigurasi yang sedikit berbeda untuk mengaktifkan mesin pencari kata kunci.
localhost:8080
(atau URL apa pun tempat Anda menjalankan redirector) di Firefox.go2
go2
.http://localhost:8080/?keyword=%s
Sekarang browser Anda dapat digunakan untuk mengakses go2redirector seperti mesin pencari. Tetapkan kata kunci ke go2
dan gunakan kotak pencarian
go2 wiki/es
Jika browser Anda dialihkan ke Wikipedia versi bahasa Spanyol, Anda sudah siap.
.
awalan untuk kata kunci apa pun./
dalam string pengalihan yang dimasukkan pengguna. Misalnya, go2 planets/mars/weather
akan memiliki kolom "planet" (kata kunci), "mars" (tag), dan parameter "cuaca".Kurasi daftar tautan dimulai dengan memilih kata kunci yang intuitif. Ini adalah nama yang orang-orang akan mengingat daftar tautan ini. Pikirkan tentang kata kunci dan seberapa umum kata kunci tersebut. Apakah ini berlaku untuk daftar potensial lainnya? Jika ya, mungkin buatlah nama kata kunci yang lebih spesifik atau gabungkan kedua daftar tersebut.
Tag adalah nama untuk tautan dalam daftar tautan. Tag adalah kolom kedua (opsional) yang diketik pengguna dalam pengalihan go2. Jika Anda memiliki daftar bulan Mars, Anda dapat memberi tag pada salah satu bulan dengan "phobos" dan lainnya dengan "deimos", sehingga menghasilkan pengalihan seperti go2 mars/phobos
untuk langsung menuju ke tautan apa pun yang menggambarkan bulan tersebut. Tag bersifat opsional. Jika bidang kedua ditentukan oleh pengguna, pengalihan mencoba menemukan tag dalam daftar dengan nama tersebut. Jika gagal menemukannya, bidang kedua diperlakukan sebagai parameter pengganti untuk tautan tersebut.
Jika tautan ditambahkan dengan URL yang sudah kami miliki tautannya dengan kata kunci lain, kami mengizinkan Anda membuat tautan yang benar-benar baru karena Anda mungkin memiliki judul lain dan asosiasi kata kunci yang berbeda. Jika Anda mencoba menambahkan tautan duplikat, kata kunci lain akan ditampilkan kepada Anda yang sudah menggunakan tautan tersebut saat melihat dotpage.
Bidang masukan di kiri atas halaman indeks adalah titik masuk utama untuk aplikasi. Ini adalah bidang yang dapat digunakan pengguna untuk mengetikkan kombo kata kunci/tag/parameter untuk mendapatkan pengalihan atau membuat yang baru.
Tautan dapat memiliki tanggal yang ditetapkan yang menentukan masa pakai tautan dalam database tautan. Secara default, tautan tidak pernah kedaluwarsa. Pengguna dapat memasukkan berbagai masa pakai tautan. Yang paling unik dari semua masa hidup tautan yang dipilih adalah "terbakar setelah membaca" yang persis seperti apa bunyinya. Aplikasi akan menghancurkan tautan setelah satu orang menggunakannya sebagai pengalihan. Ini berguna untuk tautan yang hanya akan Anda gunakan atau bagikan satu kali. Anda harus memilih jangka waktu yang wajar untuk sebuah tautan jika itu tidak akan abadi. Ini adalah bentuk kurasi pasif dalam aplikasi, menghapus tautan ketika tanggal kedaluwarsanya sudah dekat.
Untuk memaksa akses ke halaman daftar kata kunci (apa pun perilaku daftarnya), cukup awali kata kunci tersebut dengan titik atau akhiri dengan garis miring. Melakukan hal ini akan menampilkan halaman daftar tempat tautan dapat diubah atau diberi tag.
Tautan dalam daftar dapat memiliki {1}
yang ditempatkan di mana saja di URL untuk berfungsi sebagai string substitusi untuk parameter posisi tunggal yang disediakan oleh pengguna. Saat ini, kami hanya mendukung satu parameter, namun parameter ini dapat berubah jika ada alasan kuat untuk dua parameter atau lebih. Pada versi pengalihan sebelumnya, jenis tautan dengan substitusi ini disebut tautan "khusus" dan menggunakan {*}
sebagai string substitusi. Misalnya, kata kunci go2 planets
dapat memiliki beberapa tautan yang diberi tag dengan berbagai nama planet. Setiap URL tautan dapat berisi string pengganti {1}.
Untuk masukan pengguna go2 planets/mars/weather
go2redirector akan menemukan kata kunci planets
, mencari tautan yang diberi tag mars
, mendapatkan URL www.nasa.gov/planets/mars/{1}.php
, dan melakukan a substitusi ke www.nasa.gov/planets/mars/weather.php
. Terakhir, pengguna akan diarahkan ke URL tersebut.
Saya memerlukan semua bantuan yang bisa saya dapatkan untuk membuat golang tingkat pemula saya terlihat lebih bagus. Ada fitur baru yang ingin kami tambahkan dan tidak cukup banyak orang yang melakukannya. Jika Anda ingin berkontribusi, cukup ambil repositori dan kirimkan PR! Ajukan permintaan penyempurnaan atau bug apa pun pada pelacak masalah di sini, di proyek go2redirector.
Lihat CONTRIBUTING.md
untuk informasi lebih lanjut.
Redirector f5go asli dirancang oleh Saul Pwanson, dengan bantuan dari Bryce Bockman dan Treebird(tm).