1
0
mirror of https://github.com/SpaceVim/SpaceVim.git synced 2025-01-24 02:50:03 +08:00
SpaceVim/bundle/screensaver.vim/doc/screensaver.txt

105 lines
3.3 KiB
Plaintext
Vendored

*screensaver.txt* ScreenSavers for Vim
Version: 0.2
Author: itchyny (https://github.com/itchyny)
License: MIT License
Repository: https://github.com/itchyny/screensaver.vim
Last Change: 2015/05/08 07:34:50.
CONTENTS *screensaver-contents*
Introduction |screensaver-introduction|
Commands |screensaver-commands|
Password |screensaver-password|
Options |screensaver-options|
Key Mappings |screensaver-key-mappings|
Changelog |screensaver-changelog|
==============================================================================
INTRODUCTION *screensaver-introduction*
The *screensaver.vim* provides a framework to create a *screensaver* for Vim.
------------------------------------------------------------------------------
COMMANDS *screensaver-commands*
:ScreenSaver [{name}]
*:ScreenSaver*
Starts the screensaver.
You can specify the name of the screensaver.
The following screensavers are bundled.
clock: A moving clock.
largeclock A large clock.
helloworld A hello world screensaver.
password Password lock.
If you omit the argument, it starts the clock screensaver.
------------------------------------------------------------------------------
PASSWORD *screensaver-password*
You can use the screensaver to lock the Vim.
In order to use this feature, |sha256()| function is required.
Note that this feature is just a toy. Do not use for confidential matters.
In order to use password lock, add the following configuration to your vimrc.
let g:screensaver_password = 1
Then, start the screensaver with :ScreenSaver command.
You are required to enter the password to exit the screensaver.
By default, the password is not set so just press <Enter>.
You can set your own password by the following function.
screensaver#source#password#set({string})
*screensaver#source#password#set()*
Note that the argument is not the raw password.
The argument is sha256({string}).
For example, if you want to use the password 'vim':
call screensaver#source#password#set(sha256('vim'))
However, if you write the password directly, it is not secure.
So when you write your vimrc, write the SHA256 checksum directly.
call screensaver#source#password#set('0f2ed9e33d29ff4f3b0f664ca1e1dc3df1f8b9b315b2af284c6e0e3dc52be290')
You can insert the checksum by the following key sequences in the insert mode.
<C-r>=sha256('vim')<CR>
------------------------------------------------------------------------------
OPTIONS *screensaver-options*
*g:screensaver_password*
let g:screensaver_password = {0/1}
When the variable is 1, you are required to input the password to exit
the screensaver.
The default value is 0.
------------------------------------------------------------------------------
KEY MAPPINGS *screensaver-key-mappings*
<Plug>(screensaver) *<Plug>(screensaver)*
Starts the clock screensaver.
------------------------------------------------------------------------------
CHANGELOG *screensaver-changelog*
0.2 2015-01-24, 02-11, 05-08
- Set colorcolumn=
- Set norelativenumber
- use &guicursor and &t_ve to hide the cursor
0.1 2015-01-21
- Improve g:loaded_screensaver check
- Support coompatible mode
0.0 2014-05-27,..., 2014-06-02
- Implementation and initial commit.
==============================================================================
vim:tw=78:sw=4:ts=8:ft=help:norl:noet: