Git Product home page Git Product logo

vim-mallard's Introduction

Mallard Support for Vim

Description

The vim-mallard plug-in adds support for the Mallard XML language to Vim. It provides a syntax file, a filetype plug-in, and omni completion for Mallard 1.0 according to the Mallard 1.0 specification and the official RELAX NG XML schema. In addition, it implements a number of commands that integrate it with the yelp-check utility in order to provide maximum comfort when editing Mallard pages.

Installation

Installing the Plug-in Using Vundle

To install this plug-in by using the Vundle plug-in manager, add the following line to your ~/.vimrc:

Bundle 'jhradilek/vim-mallard'

Then run the following command in Vim:

:BundleInstall

Installing the Plug-in Using Pathogen

Pathogen looks for Vim files in the ~/.vim/bundle/ directory. To make sure that this directory exists, type the following at a shell prompt:

install -d ~/.vim/bundle/

To install this plug-in, change to the ~/.vim/bundle/ directory and clone this repository in it.

Installing the Plug-in Manually

Vim looks for its configuration files in the ~/.vim/ directory. To make sure that this directory exists, type the following at a shell prompt:

mkdir ~/.vim/

To install this plug-in, change to the directory with your local copy of this repository and run the following command:

cp -R * ~/.vim/

This copies all files and directories to the ~/.vim/ directory.

Configuration

Configuring the yelp-check Support

The vim-mallard plug-in provides a number of customizable variables that allow you to adjust its behavior. To change these variables, add the following line to your ~/.vimrc file:

:let <variable_name>=<value>

The available variables are as follows:

Variable Description
g:mallard_comments_cmd The command to display editorial comments. The default value is yelp-check comments.
g:mallard_hrefs_cmd The command to display broken external links. The default value is yelp-check hrefs.
g:mallard_status_cmd The command to display the page status. The default value is yelp-check status.
g:mallard_validate_cmd The command to validate the current buffer. The default value is yelp-check validate.

For more information on how to set variables in Vim, refer to the Vim Documentation.

Adjusting File Type Detection

To configure Vim to automatically treat files with the .page or .page.stub file extension as Mallard source files, add the following line to your ~/.vimrc file:

au BufNewFile,BufRead *.page,*.page.stub set ft=mallard

For more information on how to configure file type detection in Vim, refer to the Vim Documentation.

Enabling Syntax Highlighting

To configure Vim to enable syntax highlighting, add the following line to your ~/.vimrc file:

syntax on

You can also explicitly enable file type detection by adding the following line to this file:

filetype on

For more information on how to enable and configure syntax highlighting in Vim, refer to the Vim Documentation.

Usage

To use the vim-mallard plug-in, either open a file with the .page or .page.stub file extension, or enable it for the current buffer by running the following Vim command:

:set filetype=mallard

When enabled, the vim-mallard plug-in provides syntax highlighting and omni completion for Mallard. In addition, it implements a number of commands that integrate it with the yelp-check utility if this utility is installed on the system. The available commands are as follows:

Command Description
:MallardComments Displays editorial comments in the currently edited Mallard page.
:MallardHrefs Displays broken external links in the currently edited Mallard page.
:MallardStatus Displays the status of the currently edited Mallard page.
:MallardValidate Validates the currently edited Mallard page.

See Also

  • vim-snippets โ€” A complete set of snippets for the Mallard XML language.

Copyright

Copyright ยฉ 2013 Jaromir Hradilek

This program is free software; see the source for copying conditions. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

vim-mallard's People

Contributors

jhradilek avatar

Stargazers

Shaun McCance avatar Kevin Godby avatar Steven Oliver avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.