Salesforce Reference Extension for VSCodeSearch Salesforce Developer Documentation entries in VSCode, and open them in your browser (or with experimental features: in VSCode itself!). Please Note: this is a community-made plugin, and is not affiliated with Salesforce. If the extension breaks, please open a github issue to let me know, there's a chance Salesforce may change its doc approach, necessitating an update to the plugin Repository Home: https://github.com/Oblongmana/vscode-salesforce-doc-lookup VSCode Marketplace Install: https://marketplace.visualstudio.com/items?itemName=Oblongmana.vscode-salesforce-doc-lookup Table of Contents
Current FeaturesChoose a documentation type, and type in your searchThe extensions adds commands for different types of documentation that allow you to search them in VSCode, and be taken directly to the corresponding entries in your browser (or with the experimental setting enabled, view it in a WebView in VSCode itself): The first time you call any of these commands, the Extension will call out to Salesforce to get an index of that documentation type. This will be cached, and future uses of the command will be instant. Available Documentation Types
Search dev documentation for a word or selection in your editorWith your cursor over a word in your editor, or with something in your editor selected, you can choose a documentation type and search for that string, using the new command:
Invalidating the cacheIf you need to invalidate the cache for any reason (e.g. your local documentation index contains outdated entries), there is a command for doing so:
Experimental FeaturesEXPERIMENTAL: Load Documentation in a VSCode TabLoad documentation directly in VSCode. Enable the "Use WebView" option in your Settings to use this. Please note this is in active development, and is not fully supported. If you encounter bugs, please post an issue on github. EXPERIMENTAL: New Command: "Salesforce Reference: LWC and Aura Component Library (EXPERIMENTAL)"This is a very experimental reference type - the LWC/Aura Component Library is built on an Aura app, quite different to the Angular App and ToC JSON underpinning other documentation. Report any bugs on github if you see them! EXPERIMENTAL, ADVANCED: Override Language and Version SettingsThere are now experimental, advanced settings for overriding the documentation version and language the commands use. Examples are listed below. Generally, you will likely want to avoid using Instead, favour using At some point in future, this functionality will likely be updated to "pre-check" whether versions/languages specified are available, but for now, be aware you can break it fairly easily. You can always erase any broken settings though, to go back to the default behaviour of retrieving the latest English content. Cached values are cached per language/version combination.
InstallingIn VSCode or the Extension MarketplaceSearch for "Salesforce Reference" in the Extensions view (Ctrl + Shift + X) in VSCode, or install at our VSCode Extension Marketplace page ManuallyVSIX files are available in the Version History tab of the Marketplace listing Known IssuesAdblockers and loading links in Browser - NOFIX:Because Salesforce's Doc website is an Angular app that dynamically loads content into the page after the page itself has loaded, anchor links
appear to be managed in such a way that the Angular app (rather than the browser) handles the scrolling to the requested item.
e.g. https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_string.htm#apex_System_String_substring - the
section after the Notable Differences to the original Sublime Text 3 versionSee DIFFERENCES.md for information on the differences between this and the original plugin. Also note the Current Features list above. Release NotesSee CHANGELOG.md RoadmapA rough roadmap is available at ROADMAP.md ContributingSee the Roadmap in ROADMAP.md for details on existing aims. Some not-particularly-tidy notes can be found in NOTES.md. Contributions welcome, though I suggest opening an issue ticket on github to discuss before hand. Design NotesNotes on design, future aims etc available in NOTES.md LicenseSalesforce Reference VSCode Extension Copyright (c) 2014-2020 James Hill me@jameshill.io This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program 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. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/. CreditsAll Salesforce Documentation is © Copyright 2000–2020 salesforce.com, inc. Thanks to Marco Zeuli for his contributions in the original repo to making extra types of documentation available in the plugin Credit to Luke McFarlane for the inspiration! HistoryA port of my original plugin for Sublime Text |