---

Ⅰ. 插件描述

Haskell Yesod web framework vim plugin

Ⅱ. 基本信息

创建日期：  2016-11-18 使用用户：  2 Github星：  5 插件作者：  Daniel Campoverde

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'alx741/yesod-vim'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'alx741/yesod-vim'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'alx741/yesod-vim'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/alx741/yesod.vim

Ⅳ. 文档说明

# Yesod.vim

Vim plugin for the Haskell Yesod web framework.

• Syntax for config/models
• Syntax for config/routes
• Syntax for i18n messages/
• Jump between widget Hamlet, Julius, Lucius and Cassius files
• Jump to handler files from declared routes
• Jump to and Create i18n messages
• Jump to routes and models files
• Create new handlers for routes under the cursor while in config/routes
• Touch files with altered TH and Static resources dependencies

Note: This plugin does not add syntax for shakesperean templates, there
is another plugin that does:
vim-syntax-shakespeare.

Installation

Compatible with Vundle, Pathogen, Vim-plug.

Usage

yesod.vim gives you some predefined mappings:

Map	Command	Action
gh	:YesodOpenHandler	Jump to the handler of the route under the cursor
gH	:YesodAddHandler	Create a new handler for the route under the cursor
gm	:YesodOpenMessage	Jump to or create the i18n message under the cursor
ghh	:YesodOpenHamlet	Open the current widget Hamlet file
ghj	:YesodOpenJulius	Open the current widget Julius file
ghl	:YesodOpenLucius	Open the current widget Lucius file
ghc	:YesodOpenCassius	Open the current widget Cassius file
ghT	:YesodTouch	Touch modified TH and Static resources files
gym	:YesodOpenModels	Open models file
gyr	:YesodOpenRoutes	Open routes file

Open Handler gh

Will jump to the first handler found and fill the location list with each http
method available for that handler, so you can jump between them with :lnext
and :lprev.

Note: If your using a Vim version <= 7.4.1800, the quickfix list will be
used instead (because of a nasty bug in Vim before that version), in which case
you use :cnext and :cprev.

Create Handler gH

This will use yesod-bin so be sure you have it installed.

If your project directory structure is not the scaffolding default, this may not
work!

Open i18n Message gm

It will always take you to the message for the default language.

Open Hamlet ghh, Julius ghj, Lucius ghl and Cassius ghc files

While in a hamlet, julius, lucius or cassius file you can use any of
those commands or default mappings to easily jump to the corresponding file.

Touch files ghT

Whenever you add a new static file (like an image) to static/ or modify a file
that depends on template Haskell generation use ghT to touch those, so they
are re-built.

Configuration

Mappings

You can disable the predefined mappings with:

let g:yesod_disable_maps = 1

And then add your own like:

nnoremap <leader>H :YesodAddHandler<CR>
nnoremap <leader>h :YesodOpenHandler<CR>
nnoremap <leader>m :YesodOpenMessage<CR>

nnoremap <leader>wh :YesodOpenHamlet<CR>
nnoremap <leader>wj :YesodOpenJulius<CR>
nnoremap <leader>wl :YesodOpenLucius<CR>
nnoremap <leader>wc :YesodOpenCassius<CR>

nnoremap <leader>T :YesodTouch<CR>

nnoremap <leader>M :YesodOpenModels<CR>
nnoremap <leader>R :YesodOpenRoutes<CR>

Handlers

The Yesod default location for handlers is Handler in the project root. If you
keep your handlers in more than one directory, lets say for instance:
src/ and moreHandlers/, you can configure it like:

let g:yesod_handlers_directories = ['Handler', 'src', 'moreHandlers']

The Handlers directories you define will be searched recursively.

i18n Messages

Default i18n language to use:

let g:yesod_messages_default_lang = "en"

Messages directory:

let g:yesod_messages_path = "messages"

Screenshots

config/models and config/routes files: