Newpaper for Neovim

ℹ️ Info

A fork of material.nvim colorscheme for Neovim using Papercolor color palette with small changes written in Lua. $\LaTeX$ syntax highlight get from sublime-writing-color-scheme.

newpaper.nvim is meant to be a fast and modern colorscheme written in Lua that supports a lot of the new features added to Neovim like built-in LSP and TreeSitter.

Light

Dark

🌟 Features

• Two styles to choose from:
  • Light
  • Dark
• Lualine theme
• Ability to change background on sidebar windows like NvimTree, terminal etc.
• Asynchronous highlight loading which makes the theme extremely fast
• Added functions for live theme switching without the need to restart Neovim
• Extra syntax highlight and extends treesitter queries for some grammars.
• Extras colors configs for terminal-based and GUI application.
• lsp-semantic-highlight
• Support regex highlight with treesitter. Colors pick from regexr.com.

Extra syntax highlights

:thumbsup: - detailed, :white_check_mark: - support and recomended as default, :heavy_check_mark: - support, :x: - not support

🔌 Supported plugins

• bufferline.nvim
• cheatsheet.nvim
• Dashboard
• flash.nvim
• fugitive
• Git Gutter
• Git Signs
• git-messenger
• glyph-palette.vim
• headlines.nvim
• highlight-undo.nvim
• lazy.nvim
• lazygit.nvim with extras for light🖼️ or dark🖼️ background.
• Indent-Blankline.nvim
• litee.nvim
• LSP Diagnostics with colors from lsp-colors
• lspsaga.nvim
• Lualine🖼️
• mason.nvim
• mini.nvim
• Neogit
• noice.nvim
• nvim-cmp
• nvim-dap-ui
• nvim-dap-virtual-text
• nvim-dap
• nvim-lsp-installer
• nvim-notify
• nvim-treesitter-context
• Nvim-Tree.lua
• nvim-web-devicons
• rainbow-delimiters.nvim
• symbols-outline.nvim
• Telescope.nvim
• todo-comments.nvim🖼️
• TreeSitter
• Trouble
• vim-illuminate
• Vim-Jinja2-Syntax
• vim-LanguageTool
• vim-lua
• vim-rbs
• vim-ruby
• vim-sneak
• vim-toml
• vimtex
• virt-column.nvim
• vista.vim
• WhichKey.nvim
• zotcite

⚡️ Requirements

• Neovim >= 0.8

📦 Installation

Install via your favorite package manager:

lazy.nvim

require("lazy").setup({
    "yorik1984/newpaper.nvim",
    priority = 1000,
    config = true,
})

⚙️ Configuration

• There are 2 different styles available:
  • dark
  • light

Set the desired style using:

" init.vim
lua << EOF
    require("newpaper").setup({
        style = "dark"
    })
EOF

-- Lua:
vim.g.newpaper_style = "dark"
require("newpaper").setup()

-- OR better
require("newpaper").setup({
    style = "dark"
})

💻 Commands

Available options

Colorscheme default settings

-- Default settings
require("newpaper").setup({
    style               = "light",
    lightness           = 0,
    saturation          = 0,
    greyscale           = false,
    editor_better_view  = true,
    terminal            = "contrast",
    sidebars_contrast   = {},
    contrast_float      = true,
    contrast_telescope  = true,
    operators_bold      = true,
    delimiters_bold     = false,
    brackets_bold       = false,
    delim_rainbow_bold  = false,
    booleans            = "bold",
    keywords            = "bold",
    regex               = "bold",
    regex_bg            = true,
    tags                = "bold",
    tags_brackets_bold  = true,
    tex_major           = "bold",
    tex_operators_bold  = true,
    tex_brackets_bold   = false,
    tex_math_delim_bold = false,
    tex_keywords        = "NONE",
    tex_zone            = "italic",
    tex_arg             = "italic",
    error_highlight     = "undercurl",
    italic_strings      = true,
    italic_comments     = true,
    italic_doc_comments = true,
    italic_functions    = false,
    italic_variables    = false,
    borders             = true,
    disable_background  = false,
    lsp_virtual_text_bg = true,
    hide_eob            = false,
    colors              = {},
    colors_advanced     = {},
    custom_highlights   = {},
    lualine_bold        = true,
    lualine_style       = "light",
    devicons_custom     = {},
})

Colorscheme customizing

-- Example config in lua with global variables
vim.g.newpaper_style             = "dark"
vim.g.newpaper_keywords          = "italic"
vim.g.newpaper_borders           = false
vim.g.newpaper_colors            = { teal = "#0000FF" }
vim.g.newpaper_colors_advanced   = { keyword = "#AA00AA", string = "#008800" }
vim.g.newpaper_custom_highlights = {
    Float     = { fg = vim.g.newpaper_colors.teal },
    Number    = { fg = "#00FF00" },
    rubyClass = { fg = "#00FFF0" },
    Comment   = { fg = "#FF0000", style = "italic,underline" }
}
require("newpaper").setup()

-- OR better with user configuration
local colors            = { teal = "#0000FF" } -- use one color for many groups
local colors_advanced   = { keyword = "#AA00AA", string = "#008800" }
local custom_highlights = {
    Float     = { fg = colors.teal }, -- prefer override by name
    Number    = { fg = "#00FF00" },   -- but hex colos also good
    rubyClass = { fg = "#00FFF0" },
    Comment   = { fg = "#FF0000", style = "italic,underline" },
}
require("newpaper").setup({
    style    = "dark",
    keywords = "italic",
    -- ...
    colors              = colors,
    colors_advanced     = colors_advanced,
    custom_highlights   = custom_highlights,
    -- ...
    devicons_custom     = { gui = "#FFFF00", cterm = 3},
})

" init.vim
lua << EOF
    require("newpaper").setup({
        style    = "dark",
        keywords = "italic",
        borders  = false,
        colors   = { black = "#000000", bg = "#0F111A" }
    })
EOF

⚠️guicursor customizing

-- guicursor advansed settigs:
-- colorsheme predefine colors for various cursors type:
{
    Cursor       = { fg = newpaper.bg, bg = newpaper.cursor },     -- Character under the cursor
    nCursor      = { fg = newpaper.bg, bg = newpaper.teal },       -- Normal mode
    vCursor      = { fg = newpaper.bg, bg = newpaper.purple },     -- Visual mode
    veCursor     = { fg = newpaper.bg, bg = newpaper.darkpurple }, -- Visual mode with "selection" "exclusive" (same as "v", if not specified)
    oCursor      = { fg = newpaper.bg, bg = newpaper.navy },       -- Operator-pending mode
    iCursor      = { fg = newpaper.bg, bg = newpaper.green },      -- Insert mode
    rCursor      = { fg = newpaper.bg, bg = newpaper.magenta },    -- Replace mode
    cCursor      = { fg = newpaper.bg, bg = newpaper.darkorange }, -- Command-line Normal (append) mode
    ciCursor     = { fg = newpaper.bg, bg = newpaper.darkorange }, -- Command-line Insert mode
    crCursor     = { fg = newpaper.bg, bg = newpaper.darkorange }, -- Command-line Replace mode
    smCursor     = { fg = newpaper.bg, bg = newpaper.yellow },     -- showmatch in Insert mode
    TermCursor   = { fg = newpaper.bg, bg = newpaper.cursor },     -- active cursor in terminal
    TermCursorNC = { fg = newpaper.bg, bg = newpaper.lightgrey },  -- inactive cursor in terminal
}
-- This colors cam be using or overriding by own colors. See above.

-- init.lua example
vim.o.guicursor = "n:block-nCursor,v:block-vCursor,i:ver25-iCursor,r:hor25-rCursor,c:ver25-cCursor"

For more information see in :h guicursor

🎨 Lualine theme

Enable the newpaper theme for Lualine:

require("lualine").setup({
    options = {
        -- ... your lualine config
    },
    -- example config of sections
    sections = {
        lualine_b = {
            {
                "diff",
                diff_color = {
                -- specific colors from theme with bg color of section
                    added    = "GitSignsAdd",
                    modified = "GitSignsChange",
                    removed  = "GitSignsDelete",
                },
                symbols = {
                    added    = " ",
                    modified = " ",
                    removed  = " ",
                },
            },
        },
        lualine_x = {
            {
                "diagnostics",
                sources = { "nvim_diagnostic" },
                sections = { "error", "warn", "info", "hint" },
                diagnostics_color = {
                -- specific colors from theme with bg color of section
                    error = "LualineDiagnosticError",
                    warn  = "LualineDiagnosticWarn",
                    info  = "LualineDiagnosticInfo",
                    hint  = "LualineDiagnosticHint",
                },
                symbols = {
                    error = " ",
                    warn = " ",
                    info = " ",
                    hint = " ",
                },
            },
        },
    }
})

Lualine theme name and style automatically using from main theme

⚙️ Hint

You can temporally use just only lualine theme with any others colorschemes. It also depends on vim.o.background.

-- Set bold style
vim.g.newpaper_lualine_bold = true
-- If you want to enable style like in main colorscheme no need to set style of lualine
vim.g.newpaper_lualine_style = "light"
-- Also you can predefine colors
vim.g.newpaper_colors        = { teal = "#008080" }

-- disable main theme
-- require("newpaper").setup()

-- enable other colorscheme
-- ...

⚠️ More recommended configuration here: yorik1984/lualine-theme.nvim

📺 Screenshots lualine

light

dark

📺 Screenshots

🎼 Languages

RUBY

Source code HERE

Treesitter

vim-ruby

LUA

Source code HERE

Treesitter

vim-lua

MARKDOWN

Source code HERE

vim and Treesitter

COMMENT-TODO

Source code HERE

Treesitter

🎛️ Plugins

todo-comments.nvim

Source code HERE

Example config:

{
    keywords = {
        FIX =  { icon = "", alt = { "FIXME", "BUG", "FIXIT", "ISSUE", "ERROR" } },
        TODO = { icon = "", alt = { "WIP" } },
        HACK = { icon = "" },
        WARN = { icon = "" },
        PERF = { icon = "" },
        NOTE = { icon = "󰎞", alt = { "INFO", "DOCS" } },
        TEST = { icon = "" },
    },
    highlight = {
        multiline = true,
        keyword   = "bg",
        after     = "fg",
    },
}

❔ FAQ

For a complete guide on usage and Configuration of the theme, see :help newpaper.nvim.

Extras

Extra config with newpaper-based color palette for some terminal and GUI application.

• lazygit
• Windows Terminal

©️ Credits

• onedark.nvim ⚡
• sublime-writing-color-scheme
• material.nvim
• vimtex
• tokyonight.nvim
• papercolor-theme
• vim-shoot -- generate HTML version of highlighting
• toml -- spec and code preview example
• yaml -- spec and code preview example
• catppuccin -- community-driven pastel theme
• thanks to lukas-reineke for inspired by good documentation style

🛠️ TODO

• [x] Add dark style
• [ ] Add syntax screenshots:
  • [x] Ruby
  • [x] Lua
  • [x] TOML
  • [x] YAML
  • [x] Markdown
  • [x] Pandoc
  • [ ] LaTeX
  • [ ] HTML
  • [ ] Python
  • [ ] COBOL
• [ ] Add plugins screenshots:
  • [x] todo-comments.nvim
  • [ ] LSP Diagnostics
  • [ ] Lsp Saga
  • [ ] nvim-cmp
  • [ ] Trouble
  • [ ] Telescope.nvim
  • [ ] NvimTree.lua
  • [ ] WhichKey.nvim
  • [ ] lazy.nvim
• [-] Add extra syntax highlights:
  • [x] $\LaTeX$
  • [x] Ruby
  • [x] Lua
  • [x] TOML
  • [x] YAML
  • [x] Jinja
  • [x] regex with treesitter
  • [x] query with treesitter
  • [x] Markdown
  • [x] Pandoc
  • [x] HTML
  • [ ] COBOL
  • [x] Python
  • [x] Rust
• [ ] Add plugins support:
  • [ ] plaintasks.vim
  • [ ] Nvim-R
  • [ ] i3config.vim