昨天看到站長提交的翻譯專案,對這個 Wink 特別喜歡,我自己目前的部落格是使用 hexo 搭建的,但 Wink 我感覺也很不錯,這裡翻譯了一下它的 readme 檔案。後續將持續翻譯中,倉庫地址:https://github.com/leienshu/wink
介紹
Wink 的唯一任務就是幫助你用一種風格去寫作和展示你的文章。 Wink 是建立在世界上最牛逼的 PHP 框架之上的 Laravel 一個專案,它使每個人都可以輕鬆地在任何雲平臺上安裝和維護。
安裝
Wink 可以在任何 Laravel 程式上執行,它使用了一個隔離的資料庫連結和驗證系統,所以你完全沒必要去修改任何現有的專案程式碼。
使用 Composer 來安裝 Wink :
composer require writingink/wink
一旦 composer 安裝完成後,執行下面的命令:
php artisan wink:install
檢視你的 config/wink.php
檔案,wink 將使用 configure the database connection 。然後你用下面的命令替代 php artisan migrate
,執行:
php artisan wink:migrate
進入 yourproject.test/wink
後臺,並且使用提供的郵箱和密碼登入。
在建立部落格文章之前,確保你你的 image 目錄設定正確。目錄在 config/wink.php
檔案中進行設定,預設是 public/wink/images
。如果你是用最新的 Laravel 安裝 Wink ,請確保你的 public 目錄連結到了相應的儲存空間。https://learnku.com/docs/laravel/5.7/filesystem#co... 使用下面的命令:
php artisan storage:link
(可選) 訪問 https://unsplash.com/oauth/applications 建立一個新的 unsplash app 。獲取訪問金鑰並且更新 config/services.php
檔案:
'unsplash' => [
'key' => 'UNSPLASH_ACCESS_KEY',
],
更新
新增下面的命令到你的部署指令碼中去,這樣 wink 就能執行新的資料庫遷移了:
php artisan wink:migrate
你也可以使用下面的命令來重新發布這些設定:
php artisan vendor:publish --tag=wink-assets --force
主題
Wink 附帶了一個易於使用的管理後臺。當然,我們也給你的藉口提供了一個完全的控制許可權,讓你可以隨心所欲的展示你儲存的內容。下面是一個從部落格主頁獲取所有文章列表的例子:
use Wink\WinkPost;
public function index()
{
$posts = WinkPost::with('tags')
->live()
->orderBy('publish_date', 'DESC')
->simplePaginate(12);
return view('blog.index', [
'posts' => $posts
]);
}
你可以隨意配置你的路由表:
Route::get('/', 'BlogController@index');
// OR
Route::get('/blog', 'BlogController@index');
// OR
Route::domain('blog.mywebsite.com')->get('/', 'BlogController@index');
// 顯示單獨的文章
Route::get('/{tag}/{slug}', 'BlogController@post');
// OR
Route::get('/{year}/{month}/{slug}', 'BlogController@post');
路徑
Wink 目前仍然在持續開發中,我決定在這個早期階段釋出,這樣你就可以幫我改進它,不過我已經用它來執行多個網站了,包括我的個人部落格。
這就是接下來將要進行的一些開發:
- [x] 定製 Twitter/Facebook 卡片和 SEO metadata 。
- [x] 優化 CSS. 遷移到 Tailwind ?
- [x] 在 lists 中增加文字搜尋。
- [x] 通過狀態、計劃、標籤和作者過濾
- [x] 深色模式。
- [ ] 強化釋出日期選擇器。
- [ ] 建立一個人們可以立即使用的初始化主題。 @themsaid
- [ ] 優化圖片上傳並且支援裁剪圖片。
- [ ] 給文章和頁面新增影像畫廊。 @themsaid
- [ ] 增加 tests.
下面是一些我不太確定需不需要的想法:
- [ ] Email 訂閱 & 自動傳送有關新內容的郵件
- [ ] 角色設定 (Contributor / Admin)
- [ ] 本地化
- [ ] 多語言內容
- [ ] 將 metadata 新增到文章和頁面。
貢獻
Check our 共享手冊.
許可
Wink 是一個開源軟體,專案許可基於 MIT license 。
本作品採用《CC 協議》,轉載必須註明作者和本文連結