startify.txt 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919
  1. *startify.txt* The fancy start screen.
  2. *startify*
  3. __ __ ___
  4. /\ \__ /\ \__ __ /'___\
  5. ____\ \ ,_\ __ _ __\ \ ,_\/\_\/\ \__/ __ __
  6. /',__\\ \ \/ /'__`\ /\`'__\ \ \/\/\ \ \ ,__\/\ \/\ \
  7. /\__, `\\ \ \_/\ \L\.\_\ \ \/ \ \ \_\ \ \ \ \_/\ \ \_\ \
  8. \/\____/ \ \__\ \__/.\_\\ \_\ \ \__\\ \_\ \_\ \/`____ \
  9. \/___/ \/__/\/__/\/_/ \/_/ \/__/ \/_/\/_/ `/___/> \
  10. /\___/
  11. \/__/
  12. by Marco Hinz~
  13. >
  14. If you use any of my plugins, please star them on github. It's a great way
  15. of getting feedback and gives me the kick to put more time into their
  16. development.
  17. If you encounter any bugs or have feature requests, just open an issue
  18. report on Github.
  19. Thank you for flying mhi^ airlines. Get the Vim on!
  20. <
  21. ==============================================================================
  22. CONTENTS *startify-contents*
  23. INTRO .......................................... |startify-intro|
  24. USAGE .......................................... |startify-usage|
  25. OPTIONS ........................................ |startify-options|
  26. AUTOCMD ........................................ |startify-autocmd|
  27. COMMANDS ....................................... |startify-commands|
  28. MAPPINGS ....................................... |startify-mappings|
  29. COLORS ......................................... |startify-colors|
  30. FAQ ............................................ |startify-faq|
  31. EXAMPLE ........................................ |startify-example|
  32. ==============================================================================
  33. INTRO *startify-intro*
  34. Startify is a plugin that shows recently used files, bookmarks and
  35. sessions that were saved to a certain directory.
  36. ==============================================================================
  37. USAGE *startify-usage*
  38. Startify basically provides two things:
  39. 1) If you start Vim without giving any filenames to it (or pipe stuff to it so
  40. it reads from STDIN), startify will show a small but pretty start screen
  41. that shows recently used files (using viminfo) and sessions by default.
  42. Additionally, you can define bookmarks, thus entries for files that always
  43. should be available on the start screen.
  44. You can either navigate to a certain menu entry and hit enter or you just
  45. key in whatever is written between the square brackets on that line. You
  46. can even double-click anywhere on the line now.
  47. In addition, 'e' creates an empty buffer, 'i' creates an empty buffer and
  48. jumps into insert mode, 'q' quits.
  49. Moreover, you can open several files at one go. Navigate to an entry and
  50. hit either 'b' (open in same window), 's' (open in split), 'v' (open in
  51. vertical split) or 't' (open in tab). You can do that for multiple entries.
  52. You can also mix them. The order of the selections will be remembered.
  53. Afterwards execute these actions via <cr>.
  54. When the selection is finished, Startify will close automatically. You can
  55. reopen the screen via :Startify.
  56. And you can define your own custom ascii art header now!
  57. 2) It eases handling of loading and saving sessions by only working with a
  58. certain directory. These commands are used for convenience:
  59. :SLoad load a session
  60. :SSave save a session
  61. :SDelete[!] delete a session
  62. :SClose close a session
  63. If ! is given, you won't get prompted.
  64. ==============================================================================
  65. OPTIONS *startify-options*
  66. Put these variables into your vimrc. The shown assignments are also the
  67. default values.
  68. Most used options:~
  69. |g:startify_bookmarks|
  70. |g:startify_change_to_dir|
  71. |g:startify_change_to_vcs_root|
  72. |g:startify_custom_header|
  73. |g:startify_enable_special|
  74. |g:startify_list_order|
  75. |g:startify_relative_path|
  76. |g:startify_skiplist|
  77. |g:startify_update_oldfiles|
  78. Misc options:~
  79. |g:startify_custom_footer|
  80. |g:startify_custom_header_quotes|
  81. |g:startify_custom_indices|
  82. |g:startify_disable_at_vimenter|
  83. |g:startify_enable_unsafe|
  84. |g:startify_files_number|
  85. |g:startify_mapping_nowait|
  86. |g:startify_skiplist_server|
  87. |g:startify_use_env|
  88. Sessions:~
  89. |g:startify_session_autoload|
  90. |g:startify_session_delete_buffers|
  91. |g:startify_session_dir|
  92. |g:startify_session_persistence|
  93. |g:startify_session_remove_lines|
  94. |g:startify_session_savecmds|
  95. |g:startify_session_savevars|
  96. ------------------------------------------------------------------------------
  97. *g:startify_session_dir*
  98. >
  99. let g:startify_session_dir = '~/.vim/session'
  100. <
  101. The directory to save/load sessions to/from.
  102. The default for Windows systems is '$HOME\vimfiles\session'.
  103. ------------------------------------------------------------------------------
  104. *g:startify_list_order*
  105. >
  106. let g:startify_list_order = ['files', 'dir', 'bookmarks', 'sessions']
  107. <
  108. At the moment startify supports these lists:~
  109. 1) "files"
  110. This lists the most recently used files using viminfo. The number of files
  111. is limited by |g:startify_files_number|.
  112. 2) "dir"
  113. This lists the files from the current directory sorted by modification
  114. time. The number of files is limited by |g:startify_files_number|.
  115. 3) "bookmarks"
  116. This lists bookmarks, thus hardcoded files or directories that will always
  117. be shown. Have a look at |g:startify_bookmarks|.
  118. 4) "sessions"
  119. This lists all the sessions saved in the directory |g:startify_session_dir|.
  120. Section headers:~
  121. Additionally you can add lists of strings to that list. These will be shown
  122. above the following item in |g:startify_list_order|.
  123. NOTE: Section headers are context-senstive. This means that if the following
  124. item is a startify list ("dir", "bookmarks", ...) and empty (no files in the
  125. current directory, no bookmarks defined, ...), the section header won't be
  126. shown as well.
  127. NOTE: The section header use the StartifySection highlight group.
  128. Section headers example:~
  129. >
  130. let g:startify_list_order = [
  131. \ [' My most recently', ' used files'],
  132. \ 'files',
  133. \ [' My most recently used files in the current directory:'],
  134. \ 'dir',
  135. \ [' These are my sessions:'],
  136. \ 'sessions',
  137. \ [' These are my bookmarks:'],
  138. \ 'bookmarks',
  139. \ ]
  140. <
  141. Feel free to add some cool ASCII action!
  142. ------------------------------------------------------------------------------
  143. *g:startify_bookmarks*
  144. >
  145. let g:startify_bookmarks = []
  146. <
  147. A list of files or directories to bookmark. The list can contain two kinds of
  148. types. Either a path or a dictionary whereas the key is the custom index and
  149. the value the path.
  150. Example:
  151. >
  152. let g:startify_bookmarks = [ {'c': '~/.vimrc'}, '~/.zshrc' ]
  153. <
  154. NOTE: Avoid using keys from |startify-mappings| if providing custom indices.
  155. ------------------------------------------------------------------------------
  156. *g:startify_files_number*
  157. >
  158. let g:startify_files_number = 10
  159. <
  160. The number of files to list.
  161. ------------------------------------------------------------------------------
  162. *g:startify_update_oldfiles*
  163. >
  164. let g:startify_update_oldfiles = 0
  165. <
  166. Usually |v:oldfiles| only gets updated when Vim exits. Using this option updates
  167. it on-the-fly, so that :Startify is always up-to-date.
  168. ------------------------------------------------------------------------------
  169. *g:startify_session_autoload*
  170. >
  171. let g:startify_session_autoload = 0
  172. <
  173. If you fire up "vim" in a directory that contains a "Session.vim", that session
  174. will be loaded automatically. Otherwise it will be shown as the top entry in
  175. the Startify buffer.
  176. This also works if you open a bookmarked directory.
  177. Great way to create a portable project folder.
  178. ------------------------------------------------------------------------------
  179. *g:startify_session_persistence*
  180. >
  181. let g:startify_session_persistence = 0
  182. <
  183. Automatically update sessions in two cases:
  184. 1) Before leaving Vim
  185. 2) Before loading a new session via :SLoad
  186. This also works for sessions started with:
  187. >
  188. vim -S mysession.vim
  189. <
  190. ------------------------------------------------------------------------------
  191. *g:startify_session_delete_buffers*
  192. >
  193. let g:startify_session_delete_buffers = 0
  194. <
  195. Delete open buffers before loading a new session.
  196. ------------------------------------------------------------------------------
  197. *g:startify_change_to_dir*
  198. >
  199. let g:startify_change_to_dir = 1
  200. <
  201. When opening a file or bookmark, change to its directory.
  202. ------------------------------------------------------------------------------
  203. *g:startify_change_to_vcs_root*
  204. >
  205. let g:startify_change_to_vcs_root = 0
  206. <
  207. When opening a file or bookmark, seek and change to the root directory of the
  208. VCS (if there is one).
  209. At the moment only git, hg, bzr and svn are supported.
  210. ------------------------------------------------------------------------------
  211. *g:startify_skiplist*
  212. >
  213. let g:startify_skiplist = [
  214. \ 'COMMIT_EDITMSG',
  215. \ escape(fnamemodify(resolve($VIMRUNTIME), ':p'), '\') .'doc',
  216. \ 'bundle/.*/doc',
  217. \ ]
  218. <
  219. A list of Vim regular expressions that is used to filter recently used files.
  220. See |pattern.txt| for what patterns can be used.
  221. NOTE: Due to the nature of patterns, you can't just use "~/mysecret" but have
  222. to use "$HOME .'/mysecret.txt'". The former would do something entirely
  223. different: |/\~|. When using backslashes as path separators, escape them.
  224. Otherwise using "C:\this\vim\path\is\problematic" would not match what you
  225. expect, since |/\v| is a pattern, too.
  226. Example:
  227. >
  228. let g:startify_skiplist = [
  229. \ '\.vimgolf',
  230. \ '^/tmp',
  231. \ '/project/.*/documentation',
  232. \ escape(fnamemodify($HOME, ':p'), '\') .'mysecret.txt',
  233. \ ]
  234. <
  235. ------------------------------------------------------------------------------
  236. *g:startify_skiplist_server*
  237. >
  238. let g:startify_skiplist_server = []
  239. <
  240. Do not create the startify buffer, if this is a Vim server instance with a
  241. name contained in this list.
  242. Example:
  243. >
  244. let g:startify_skiplist_server = [ 'GVIM' ]
  245. <
  246. ------------------------------------------------------------------------------
  247. *g:startify_enable_special*
  248. >
  249. let g:startify_enable_special = 1
  250. <
  251. Show <empty buffer> and <quit>.
  252. ------------------------------------------------------------------------------
  253. *g:startify_enable_unsafe*
  254. >
  255. let g:startify_enable_unsafe = 0
  256. <
  257. Enable the option only in case you think Vim starts too slowly (because of
  258. :Startify) or if you often edit files on remote filesystems.
  259. It's called unsafe because it improves the time :Startify needs to execute by
  260. reducing the amount of syscalls to the underlying operating system, but
  261. sacrifices the precision of shown entries.
  262. This could lead to inconsistences in the shown :Startify entries (e.g. the
  263. same file could be shown twice, because one time file was opened via absolute
  264. path and another time via symlink).
  265. Currently this option does this:
  266. - don't resolves symlinks (readlink(2))
  267. - don't check every file if it's readable (stat(2))
  268. - don't filter through the bookmark list
  269. ------------------------------------------------------------------------------
  270. *g:startify_session_remove_lines*
  271. >
  272. let g:startify_session_remove_lines = []
  273. <
  274. Lines matching any of the patterns in this list, will be removed from the
  275. session file.
  276. Example:
  277. >
  278. let g:startify_session_remove_lines = ['setlocal', 'winheight']
  279. <
  280. Internally this simply does:
  281. >
  282. :global/setlocal/delete
  283. :global/winheight/delete
  284. <
  285. So you can use any |pattern|.
  286. NOTE: Take care not to mess up any expressions within the session file,
  287. otherwise you'll probably get problems when trying to load it.
  288. ------------------------------------------------------------------------------
  289. *g:startify_session_savevars*
  290. >
  291. let g:startify_session_savevars = []
  292. <
  293. Include a list of variables in here which you would like Startify to save into
  294. the session file in addition to what Vim normally saves into the session file.
  295. For example, Vim will not normally save all-lowercase global variables, which
  296. are common for plugin settings. It may be advisable to include
  297. |g:startify_session_savevars| and |g:startify_session_savecmds| into this list
  298. so they are saved every time the session saves.
  299. Example:
  300. >
  301. let g:startify_session_savevars = [
  302. \ 'g:startify_session_savevars',
  303. \ 'g:startify_session_savecmds',
  304. \ 'g:random_plugin_use_feature'
  305. \ ]
  306. <
  307. ------------------------------------------------------------------------------
  308. *g:startify_session_savecmds*
  309. >
  310. let g:startify_session_savecmds = []
  311. <
  312. Include a list of cmdline commands which Vim will run upon loading the
  313. session. This can be useful to set various things (other than variables,
  314. |g:startify_session_savevars| above) which Vim may not normally save into the
  315. session file, as well as run external commands upon loading a session.
  316. Example:
  317. >
  318. let g:startify_session_savecmds = [
  319. \ 'silent !pdfreader ~/latexproject/main.pdf &'
  320. \ ]
  321. <
  322. ------------------------------------------------------------------------------
  323. *g:startify_custom_indices*
  324. >
  325. let g:startify_custom_indices = []
  326. <
  327. Use any list of strings as indices instead of increasing numbers. If there are
  328. more startify entries than actual items in the custom list, the remaining
  329. entries will be filled using the default numbering scheme starting from 0.
  330. Thus you can create your own indexing scheme that fits your keyboard layout.
  331. You don't want to leave the home row, do you?!
  332. Example:
  333. >
  334. let g:startify_custom_indices = ['f', 'g', 'h']
  335. <
  336. This would result in:
  337. [f] /most/recently/used/file1
  338. [g] /most/recently/used/file2
  339. [h] /most/recently/used/file3
  340. [0] /most/recently/used/file4
  341. [1] /most/recently/used/file5
  342. [2] /most/recently/used/file6
  343. etc.
  344. If you want numbers to start at 1 instead of 0, you could use this:
  345. >
  346. let g:startify_custom_indices = map(range(1,100), 'string(v:val)')
  347. <
  348. NOTE: There is no sanitizing going on, so you should know what you're doing!
  349. Avoid using keys from |startify-mappings|.
  350. ------------------------------------------------------------------------------
  351. *g:startify_custom_header*
  352. >
  353. let g:startify_custom_header = startify#fortune#get_random_quote()
  354. <
  355. This is a list of strings to be shown before everything else. Every string
  356. will be written on its own line, hence you can use empty strings for blank
  357. lines.
  358. Static example:~
  359. >
  360. let g:startify_custom_header = ['line 1', '', 'line 3']
  361. <
  362. Static example #2:~
  363. >
  364. let g:startify_custom_header = [
  365. \ ' ________ __ __ ',
  366. \ ' __ /\_____ \/\ \\ \ ',
  367. \ ' __ __ /\_\ ___ ___ \/___//''/''\ \ \\ \ ',
  368. \ ' /\ \/\ \\/\ \ /'' __` __`\ /'' /'' \ \ \\ \_ ',
  369. \ ' \ \ \_/ |\ \ \/\ \/\ \/\ \ /'' /''__ \ \__ ,__\',
  370. \ ' \ \___/ \ \_\ \_\ \_\ \_\ /\_/ /\_\ \/_/\_\_/ ',
  371. \ ' \/__/ \/_/\/_/\/_/\/_/ \// \/_/ \/_/ ',
  372. \ ]
  373. <
  374. Dynamic example:~
  375. >
  376. let g:startify_custom_header =
  377. \ map(split(system('fortune | cowsay'), '\n'), '" ". v:val')
  378. <
  379. If you go for a dynamic header, you might find the following functions useful:
  380. startify#fortune#quote() raw random quote
  381. startify#fortune#boxed() formatted random quote in a box
  382. startify#fortune#cowsay() formatted random quote in a box + cow
  383. Try them like this:
  384. >
  385. :echo join(startify#fortune#cowsay(), "\n")
  386. <
  387. Let's assume you like the default boxed random quote, but not the ASCII art
  388. cow. You'd rather have another small ASCII art come before the quote. No
  389. problem!
  390. >
  391. let g:ascii = [
  392. \ ' __',
  393. \ '.--.--.|__|.--------.',
  394. \ '| | || || |',
  395. \ ' \___/ |__||__|__|__|',
  396. \ ''
  397. \]
  398. let g:startify_custom_header = g:ascii + startify#fortune#boxed()
  399. <
  400. Looks great! But it's not on the same column as the indices below which makes
  401. it look awkward. Let's indent the header by 3 spaces:
  402. >
  403. let g:startify_custom_header =
  404. \ map(g:ascii + startify#fortune#boxed(), '" ".v:val')
  405. <
  406. Ah, much better! There's only one issue left. If you set
  407. g:startify_custom_header this way, it will only be done once. Hence spamming
  408. :Startify will always show the same quote.
  409. If you provide a string to it instead, Startify will evaluate it every time
  410. :Startify is run:
  411. >
  412. let g:startify_custom_header =
  413. \ 'map(g:ascii + startify#fortune#boxed(), "\" \".v:val")'
  414. <
  415. Happy customizing!
  416. Also have a look at |startify-faq-08|.
  417. ------------------------------------------------------------------------------
  418. *g:startify_custom_header_quotes*
  419. If you don't set |g:startify_custom_header|, the internal cowsay implementation
  420. with shipped random quotes will be used.
  421. If you want to use your own quotes, add a list of lists, like this:
  422. >
  423. let g:startify_custom_header_quotes = [
  424. \ ['line 1', '', 'line 3'],
  425. \ ['quote #2']
  426. \ ]
  427. <
  428. ------------------------------------------------------------------------------
  429. *g:startify_custom_footer*
  430. >
  431. let g:startify_custom_footer = ''
  432. <
  433. Same as the custom header, but shown at the bottom of the startify buffer.
  434. ------------------------------------------------------------------------------
  435. *g:startify_disable_at_vimenter*
  436. >
  437. let g:startify_disable_at_vimenter = 0
  438. <
  439. Don't run Startify at Vim startup. You can still call it anytime via
  440. :Startify.
  441. -----------------------------------------------------------------------------
  442. *g:startify_relative_path*
  443. >
  444. let g:startify_relative_path = 0
  445. <
  446. Show filenames relative to the current working directory instead of as
  447. absolute paths. This only applies to the "files" list, since the "dir" list is
  448. relative by nature.
  449. -----------------------------------------------------------------------------
  450. *g:startify_use_env*
  451. >
  452. let g:startify_use_env = 0
  453. <
  454. Show environment variables in path, if their name is shorter than their value.
  455. See |startify-colors| for highlighting them.
  456. $PWD and $OLDPWD are ignored.
  457. -----------------------------------------------------------------------------
  458. *g:startify_mapping_nowait*
  459. >
  460. let g:startify_mapping_nowait = 0
  461. <
  462. Force the usage of |<nowait>| in all mappings.
  463. This helps guarding against global mappings that start with the same
  464. characters as a Startify index, but might break local mappings, e.g. when you
  465. have indexes "1" and "11", the "11" won't be accessable anymore, since "1"
  466. will be opened right way.
  467. Only use this when you know what you're doing.
  468. NOTE: This option needs at least Vim 7.3.1261. It gets ignored otherwise.
  469. ==============================================================================
  470. AUTOCMD *startify-autocmd*
  471. In case you want to alter the startify buffer to cause all kinds of mayhem, an
  472. user autocmd is issued. You can hook into it like this:
  473. >
  474. autocmd User Startified let &l:stl = ' This statusline rocks!'
  475. <
  476. ==============================================================================
  477. COMMANDS *startify-commands*
  478. *startify-:Startify*
  479. >
  480. :Startify
  481. <
  482. Open the startify buffer.
  483. *startify-:SSave*
  484. *startify-:SDelete*
  485. >
  486. :SSave [session]
  487. :SDelete [session]
  488. <
  489. Save or delete a session. If you don't specify a session name, it will prompt
  490. you for one.
  491. *startify-:SLoad*
  492. >
  493. :SLoad [session]
  494. <
  495. Load a session. If you don't specify a session name, it will either prompt you
  496. for one (Windows) or load the last used session (Unix).
  497. Providing only a part of the session name works too, if you complete the
  498. argument with either <c-d> or <tab> afterwards.
  499. *startify-:SClose*
  500. >
  501. :SClose
  502. <
  503. Save and close the current session, close all listed buffers, and open the
  504. Startify buffer.
  505. ==============================================================================
  506. MAPPINGS *startify-mappings*
  507. Some things are remapped in the startify buffer..
  508. >
  509. q
  510. <
  511. Close startify. Also quit Vim if it is the only buffer.
  512. >
  513. e
  514. <
  515. Close startify and create a blank buffer.
  516. >
  517. i
  518. <insert>
  519. <
  520. Close startify, create a blank buffer and jump into insert mode right away.
  521. >
  522. <2-LeftMouse>
  523. <
  524. Use a simple mouse click to open the targeted entry.
  525. >
  526. [any number that is shown between square brackets]
  527. <
  528. Open the entry with the given number.
  529. >
  530. b
  531. s
  532. v
  533. t
  534. <
  535. Mark current entry to be opened in either the same window, in a split window,
  536. in a vertical split window or in a new tab.
  537. >
  538. <cr>
  539. <
  540. Open all marked entries. If nothing was marked beforehand, just open the
  541. current entry.
  542. If you want to use another key instead of <cr>, put this in your vimrc:
  543. >
  544. autocmd User Startified nmap <buffer> o <plug>(startify-open-buffers)
  545. <
  546. ==============================================================================
  547. COLORS *startify-colors*
  548. You can overwrite the highlight groups used by startify. The plugin defines
  549. these groups:
  550. Highlight group | Description | Default
  551. ------------------------------------------------------------------
  552. | |
  553. StartifyBracket | [,] | linked to Delimiter
  554. StartifyFile | the actual file | <none>
  555. StartifyFooter | the custom footer | linked to Normal
  556. StartifyHeader | the custom header | linked to Normal
  557. StartifyNumber | the numbers between [] | linked to Number
  558. StartifyPath | the path to a file | <none>
  559. StartifySection | section headers | linked to Special
  560. StartifySelect | selected entries | linked to Title
  561. StartifySlash | slashes in paths | <none>
  562. StartifySpecial | <empty buffer>,<quit> | <none>
  563. StartifyVar | environment variables | linked to StartifyPath
  564. Example: (my terminal emulator supports 256 colors)
  565. >
  566. highlight StartifyBracket ctermfg=240
  567. highlight StartifyFooter ctermfg=240
  568. highlight StartifyHeader ctermfg=114
  569. highlight StartifyNumber ctermfg=215
  570. highlight StartifyPath ctermfg=245
  571. highlight StartifySlash ctermfg=240
  572. highlight StartifySpecial ctermfg=240
  573. <
  574. ==============================================================================
  575. FAQ *startify-faq*
  576. |startify-faq-01| I don't want the start screen to use cursorline!
  577. |startify-faq-02| Recent files aren't shown!
  578. |startify-faq-03| I have broken colors when using sessions!
  579. |startify-faq-04| How to disable common but unimportant files?
  580. |startify-faq-05| CtrlP or NERDTree open a split in Startify!
  581. |startify-faq-06| How do I get both NERDTree and Startify working at
  582. startup?
  583. |startify-faq-07| The session autoload feature is not working!
  584. |startify-faq-08| How do I center my header/footer?
  585. |startify-faq-09| tmux-resurrect?
  586. |startify-faq-10| Temporarily skip Startify at start?
  587. |startify-faq-11| How to use the output of a command as header?
  588. |startify-faq-12| There is an empty window with vim-plug!
  589. |startify-faq-13| How to disable random quotes header?
  590. ------------------------------------------------------------------------------
  591. *startify-faq-01*
  592. I want to use cursorline!~
  593. Startify issues a User event when it's finished. It can be used to set
  594. buffer-local options etc.
  595. >
  596. autocmd User Startified setlocal cursorline
  597. <
  598. ------------------------------------------------------------------------------
  599. *startify-faq-02*
  600. Recent files aren't shown!~
  601. Perhaps the problem is that the viminfo file..
  602. - doesn't exist
  603. - is invalid
  604. - is empty
  605. - can't be read (check permissions)
  606. I suggest the following steps:
  607. 1) Create a new directory:
  608. >
  609. $ mkdir -p ~/.vim/files/info
  610. <
  611. 2) Put this into your vimrc:
  612. >
  613. set viminfo='100,n$HOME/.vim/files/info/viminfo
  614. <
  615. See |'viminfo'| for information about the second step and what it does
  616. exactly.
  617. ------------------------------------------------------------------------------
  618. *startify-faq-03*
  619. I have broken colors when using sessions!~
  620. Nothing this plugin could do about. Try playing around with 'sessionoptions'.
  621. NOTE: Startify removes 'options' from the session options automatically,
  622. because it's the source of many problems.
  623. Some people swear it works for them with these settings:
  624. >
  625. set sessionoptions=blank,curdir,folds,help,tabpages,winpos
  626. <
  627. ------------------------------------------------------------------------------
  628. *startify-faq-04*
  629. How to disable common but unimportant files?~
  630. Use |g:startify_skiplist|.
  631. ------------------------------------------------------------------------------
  632. *startify-faq-05*
  633. CtrlP or NERDTree open a split in Startify!~
  634. Put this in your vimrc:
  635. >
  636. autocmd User Startified setlocal buftype=
  637. <
  638. If you're using CtrlP without NERDTree, there is an even more elegant
  639. solution:
  640. >
  641. let g:ctrlp_reuse_window = 'startify'
  642. <
  643. ------------------------------------------------------------------------------
  644. *startify-faq-06*
  645. How do I get both NERDTree and Startify working at startup?~
  646. Put this in your vimrc:
  647. >
  648. autocmd VimEnter *
  649. \ if !argc()
  650. \ | Startify
  651. \ | NERDTree
  652. \ | wincmd w
  653. \ | endif
  654. <
  655. ------------------------------------------------------------------------------
  656. *startify-faq-07*
  657. The session autoload feature is not working!~
  658. Do you have NERDTree installed by any chance? If so, try this:
  659. >
  660. let NERDTreeHijackNetrw = 0
  661. <
  662. ------------------------------------------------------------------------------
  663. *startify-faq-08*
  664. How do I center my header/footer?~
  665. Try something along these lines:
  666. >
  667. function! s:filter_header(lines) abort
  668. let longest_line = max(map(copy(a:lines), 'len(v:val)'))
  669. let centered_lines = map(copy(a:lines),
  670. \ 'repeat(" ", (&columns / 2) - (longest_line / 2)) . v:val')
  671. return centered_lines
  672. endfunction
  673. let g:startify_custom_header = s:filter_header(['a', 'bb', 'ccc'])
  674. <
  675. ------------------------------------------------------------------------------
  676. *startify-faq-09*
  677. tmux-resurrect?~
  678. If you use tmux-resurrect to restore your tmux environment, you can use :SLoad
  679. to load your last used session right away:
  680. >
  681. set -g @resurrect-processes '"vim->vim +SLoad"'
  682. <
  683. ------------------------------------------------------------------------------
  684. *startify-faq-10*
  685. Temporarily skip Startify at start?~
  686. In some cases you might need to skip Startify at start. E.g.
  687. >
  688. vim +VimwikiMakeDiaryNote
  689. <
  690. Startify would interfere in this case. A simple way to avoid that would be:
  691. >
  692. vim --cmd 'let g:startify_disable_at_vimenter = 1' +VimwikiMakeDiaryNote
  693. <
  694. ------------------------------------------------------------------------------
  695. *startify-faq-11*
  696. How to use the output of a command as header?~
  697. >
  698. redir => test
  699. silent echo 'one'
  700. silent echo 'two'
  701. silent echo 'three'
  702. redir END
  703. let g:startify_custom_header =
  704. \ map(split(test), 'repeat(" ", 10) . v:val')
  705. <
  706. |:redir| puts a string into 'test'. Then we turn it into a list of strings.
  707. Then we shift each string to the right by 10 spaces. Afterwards we add an
  708. empty string to the list, which results in an empty line in the header.
  709. ------------------------------------------------------------------------------
  710. *startify-faq-12*
  711. There is an empty window with vim-plug!~
  712. After start there might be only the Startify buffer which is marked as
  713. |unlisted-buffer|. The problem arises if you use :PlugUpdate followed by 'D'
  714. to see the changes. An empty window!
  715. The actual problem is that Vim won't close the last listed buffer. Try this:
  716. >
  717. $ vim -u NONE -N
  718. :set nobuflisted
  719. :new
  720. :bd
  721. <
  722. It won't close the buffer and therefore the window. This also happens in
  723. vim-plug. Note that this is no bug in neither plugin, it's a Vim weirdness.
  724. Workaround #1:~
  725. >
  726. autocmd User Startified setlocal buflisted
  727. <
  728. In some cases this could break other plugins at start (I look at you
  729. NERDTree), but works well most of the time.
  730. Workaround #2:~
  731. >
  732. let g:plug_window = 'enew' " or maybe 'tabnew'
  733. <
  734. This will open the plug buffer in the current window instead of creating a new
  735. window on the left side. Mind that this will also close the Startify buffer
  736. since it will be hidden.
  737. ------------------------------------------------------------------------------
  738. *startify-faq-13*
  739. How to disable random quotes header?~
  740. >
  741. let g:startify_custom_header = []
  742. <
  743. See |g:startify_custom_header|.
  744. ==============================================================================
  745. EXAMPLE *startify-example*
  746. This is my configuration..
  747. >
  748. autocmd User Startified setlocal cursorline
  749. let g:startify_enable_special = 0
  750. let g:startify_files_number = 8
  751. let g:startify_relative_path = 1
  752. let g:startify_change_to_dir = 1
  753. let g:startify_update_oldfiles = 1
  754. let g:startify_session_autoload = 1
  755. let g:startify_session_persistence = 1
  756. let g:startify_session_delete_buffers = 1
  757. let g:startify_list_order = [
  758. \ [' LRU:'],
  759. \ 'files',
  760. \ [' LRU within this dir:'],
  761. \ 'dir',
  762. \ [' Sessions:'],
  763. \ 'sessions',
  764. \ [' Bookmarks:'],
  765. \ 'bookmarks',
  766. \ ]
  767. let g:startify_skiplist = [
  768. \ 'COMMIT_EDITMSG',
  769. \ 'bundle/.*/doc',
  770. \ '/data/repo/neovim/runtime/doc',
  771. \ '/Users/mhi/local/vim/share/vim/vim74/doc',
  772. \ ]
  773. let g:startify_bookmarks = [
  774. \ { 'c': '~/.vim/vimrc' },
  775. \ '~/golfing',
  776. \ ]
  777. let g:startify_custom_footer =
  778. \ ['', " Vim is charityware. Please read ':help uganda'.", '']
  779. hi StartifyBracket ctermfg=240
  780. hi StartifyFile ctermfg=147
  781. hi StartifyFooter ctermfg=240
  782. hi StartifyHeader ctermfg=114
  783. hi StartifyNumber ctermfg=215
  784. hi StartifyPath ctermfg=245
  785. hi StartifySlash ctermfg=240
  786. hi StartifySpecial ctermfg=240
  787. <
  788. ==============================================================================
  789. vim: tw=78