This commit is contained in:
parent
d0db855704
commit
df56d4a023
|
@ -75,13 +75,13 @@ We believe that Texinfo deserves more users, for it is an excellent format for
|
||||||
writing software manuals, as well as other technical materials. We chose Visual
|
writing software manuals, as well as other technical materials. We chose Visual
|
||||||
Studio Code, one of the most popular code editors as of 2020, and developed this
|
Studio Code, one of the most popular code editors as of 2020, and developed this
|
||||||
very extension, vscode-texinfo, which provides some useful features for Visual
|
very extension, vscode-texinfo, which provides some useful features for Visual
|
||||||
Studio Code in regard to the Texinfo format, in the hope that more developers
|
Studio Code regarding the Texinfo format, in the hope that more developers can
|
||||||
can benefit from it.
|
benefit from it.
|
||||||
|
|
||||||
vscode-texinfo is free software. You can redistribute it and/or modify it under
|
vscode-texinfo 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
|
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
|
Foundation, either @url{https://www.gnu.org/licenses/gpl-3.0-standalone.html,
|
||||||
version.
|
version 3 of the License}, or (at your option) any later version.
|
||||||
|
|
||||||
@menu
|
@menu
|
||||||
* Contributing:: Contribute to vscode-texinfo.
|
* Contributing:: Contribute to vscode-texinfo.
|
||||||
|
@ -91,10 +91,9 @@ version.
|
||||||
@node Contributing
|
@node Contributing
|
||||||
@section Contributing
|
@section Contributing
|
||||||
|
|
||||||
This project is hosted on @url{https://sv.gnu.org/p/vscode-texinfo, Savannah},
|
This project is hosted on @url{https://sv.gnu.org/p/vscode-texinfo, Savannah}.
|
||||||
where contribution takes place. Any kind of contribution is welcome, including
|
Any kind of contribution is welcome, including bug reports, patches, and general
|
||||||
bug reports, patches, and general discussions regarding the usage of
|
discussions regarding the usage of vscode-texinfo.
|
||||||
vscode-texinfo.
|
|
||||||
|
|
||||||
Before you submit something, please make sure that you have read this manual,
|
Before you submit something, please make sure that you have read this manual,
|
||||||
and no one else has posted the same content.
|
and no one else has posted the same content.
|
||||||
|
@ -117,16 +116,25 @@ Code since 1.40, but not all versions are tested. It's recommended to install a
|
||||||
latest release.
|
latest release.
|
||||||
@end quotation
|
@end quotation
|
||||||
|
|
||||||
The easiest way to install vscode-texinfo is from the extension marketplace,
|
The easiest way to install vscode-texinfo is from the extension marketplace.
|
||||||
either @url{https://open-vsx.org/extension/CismonX/texinfo, Open VSX Registry},
|
Click the ``Extensions'' tab on Visual Studio Code's sidebar, type ``texinfo''
|
||||||
or the proprietary Visual Studio Marketplace. Click the ``Extensions'' tab on
|
and you can find and install this extension.
|
||||||
Visual Studio Code's sidebar, type ``texinfo'' and you can find and install this
|
|
||||||
extension.
|
|
||||||
|
|
||||||
You can also download the @code{.vsix} file, and manually install it to Visual
|
@menu
|
||||||
Studio Code (via command palette: @code{Extensions: Install from VSIX...}).
|
* Manual Installation:: Download and install vscode-texinfo manually
|
||||||
|
* Build from Source:: Build vscode-texinfo from source code.
|
||||||
|
@end menu
|
||||||
|
|
||||||
Before you manually install a @code{.vsix} file downloaded from a third party,
|
|
||||||
|
@node Manual Installation
|
||||||
|
@section Manual Installation
|
||||||
|
|
||||||
|
You can manually download the @code{.vsix} file, from either Savannah's
|
||||||
|
@url{https://dl.sv.gnu.org/releases/vscode-texinfo/, download area},
|
||||||
|
@url{https://open-vsx.org/extension/CismonX/texinfo, Open VSX Registry}, or the
|
||||||
|
proprietary Visual Studio Marketplace.
|
||||||
|
|
||||||
|
Before you install a @code{.vsix} file downloaded from a third party,
|
||||||
you should check whether the file matches a trusted signature:
|
you should check whether the file matches a trusted signature:
|
||||||
|
|
||||||
@example
|
@example
|
||||||
|
@ -137,9 +145,8 @@ wget https://dl.sv.gnu.org/releases/vscode-texinfo/texinfo-0.2.0.vsix.sig.asc
|
||||||
gpg --verify texinfo-0.2.0.vsix.sig.asc texinfo-0.2.0.vsix
|
gpg --verify texinfo-0.2.0.vsix.sig.asc texinfo-0.2.0.vsix
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@menu
|
Finally, install the @code{.vsix} file to Visual Studio Code via command
|
||||||
* Build from Source:: Build vscode-texinfo from source code.
|
palette: @code{Extensions: Install from VSIX...}.
|
||||||
@end menu
|
|
||||||
|
|
||||||
|
|
||||||
@node Build from Source
|
@node Build from Source
|
||||||
|
@ -295,13 +302,26 @@ which converts a Texinfo document to some other format, like HTML, PDF,
|
||||||
plain text, etc.
|
plain text, etc.
|
||||||
|
|
||||||
To specify the location of @code{makeinfo}, edit the configuration item
|
To specify the location of @code{makeinfo}, edit the configuration item
|
||||||
@code{texinfo.makeinfo}. If the executable is not located in @code{$PATH}, an
|
@code{texinfo.makeinfo}. If it's not located in @code{$PATH}, an absolute path
|
||||||
absolute path should be specified. Also note that the path should not contain
|
should be specified. Also note that the path should not contain any command line
|
||||||
any command line arguments.
|
arguments.
|
||||||
|
|
||||||
To check whether GNU Texinfo is correctly installed and configured, open a
|
To check whether GNU Texinfo is correctly installed and configured, see
|
||||||
Texinfo document, and look for a ``GNU Texinfo'' status bar item on the right
|
@ref{Version Indicator}.
|
||||||
side of the status bar.
|
|
||||||
|
@menu
|
||||||
|
* Version Indicator:: Show the installed version of GNU Texinfo
|
||||||
|
* HTML Preview:: Display document preview in HTML format.
|
||||||
|
* Diagnosis:: Show diagnostic information.
|
||||||
|
@end menu
|
||||||
|
|
||||||
|
|
||||||
|
@node Version Indicator
|
||||||
|
@section Version Indicator
|
||||||
|
|
||||||
|
The version indicator is as status bar item with text ``GNU Texinfo''. It is
|
||||||
|
located on the right side of the status bar, which is shown when the active text
|
||||||
|
editor contains a Texinfo document.
|
||||||
|
|
||||||
If you see a @b{check icon} and the version of GNU Texinfo, then
|
If you see a @b{check icon} and the version of GNU Texinfo, then
|
||||||
congratulations, you're all set. If a @b{cross icon} is displayed, it means
|
congratulations, you're all set. If a @b{cross icon} is displayed, it means
|
||||||
|
@ -311,10 +331,10 @@ If a @b{warning icon} is displayed, it means that the currently installed GNU
|
||||||
Texinfo is outdated, or has an unrecognizable version number. In that case, some
|
Texinfo is outdated, or has an unrecognizable version number. In that case, some
|
||||||
features may not work as expected.
|
features may not work as expected.
|
||||||
|
|
||||||
@menu
|
@quotation Note
|
||||||
* HTML Preview:: Display document preview in HTML format.
|
The version indicator does not automatically refresh since the activation of the
|
||||||
* Diagnosis:: Show diagnostic information.
|
extension. To manually trigger a refresh, click the status bar item.
|
||||||
@end menu
|
@end quotation
|
||||||
|
|
||||||
|
|
||||||
@node HTML Preview
|
@node HTML Preview
|
||||||
|
|
Loading…
Reference in New Issue
Block a user