Giter VIP home page Giter VIP logo

commentlinks's Introduction

CommentLinks

Easily link from comments to external files or documentation.

Features

gif

  • Within a comment, add a link by enclosing it in double "[" brackets ie

[[docs/readme.md]]

  • Searches from the root of your workspace, but it also works with relative paths!

[[./docs/folder/readme.md]]

Requirements

Currently, this extension only supports files where comments are delimited by /*, //, *, <!-- or #. So, it should work with Javascript/Typescript, Python, HTML files and any other languages .

Currently you can only add one link per line. If you need multiple links, add each one on a different line.

Extension Settings

No settings to change. Just enable and enjoy! CodeLens hints will display above any comment with a valid filename.

Known Issues

As it parses line-by-line, it won't properly detect when a link is within a multi-line comment unless the line starts with one of the delimiters. For instance,

This won't work!

/*
  This link won't work [[docs/readme.md]]
*/

A simple workaround is just to add a comment delimiter to the beginning of every line with a link, regardless of whether it's required or not.

/*
 * This link is working now! [[docs/readme.md]]
 */

Release Notes

1.0.0

Initial release of CommentLinks

Future Roadmap

  • Ability to link to a specific heading in a markdown file
  • Tooling to help with refactoring - when files are renamed / moved, updating their comment links
  • Better comment detection
  • Tests

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.