src/Tools/VSCode/README.md
author wenzelm
Fri, 25 Feb 2022 13:15:27 +0100
changeset 75140 4400eeb6c32d
parent 73539 f800f8becbfb
child 75141 d65728c611f7
permissions -rw-r--r--
updated notes on Isabelle/VSCode development;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
     1
# Isabelle/VSCode development #
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
     2
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
     3
## System setup ##
64605
9c1173a7e4cb basic support for VSCode Language Server protocol;
wenzelm
parents:
diff changeset
     4
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
     5
* install default node.js (e.g. via Ubuntu package)
64605
9c1173a7e4cb basic support for VSCode Language Server protocol;
wenzelm
parents:
diff changeset
     6
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
     7
* update to recent stable version:
64605
9c1173a7e4cb basic support for VSCode Language Server protocol;
wenzelm
parents:
diff changeset
     8
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
     9
    sudo npm cache clean -f
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    10
    sudo npm install -g n
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    11
    sudo n stable
66596
c5bd8267d832 simplified README: this is for development version;
wenzelm
parents: 65158
diff changeset
    12
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    13
* install vsce:
64605
9c1173a7e4cb basic support for VSCode Language Server protocol;
wenzelm
parents:
diff changeset
    14
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    15
    sudo npm install -g vsce
64605
9c1173a7e4cb basic support for VSCode Language Server protocol;
wenzelm
parents:
diff changeset
    16
9c1173a7e4cb basic support for VSCode Language Server protocol;
wenzelm
parents:
diff changeset
    17
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    18
## Edit and debug ##
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    19
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    20
* Shell commands within $ISABELLE_HOME directory:
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    21
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    22
    isabelle vscode --uninstall-extension makarius.Isabelle
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    23
    isabelle vscode src/Tools/VSCode/extension
64696
e991a4fab0dc publish extension on Visual Studio Marketplace;
wenzelm
parents: 64695
diff changeset
    24
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    25
* VSCode commands:
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    26
    Run / Start Debugging (F5)
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    27
    File / Open Folder: e.g. `src/HOL/Examples/` then open .thy files
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    28
64740
01af31db2720 proper packaging;
wenzelm
parents: 64733
diff changeset
    29
75140
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    30
## Build and install ##
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    31
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    32
* Shell commands within $ISABELLE_HOME directory:
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    33
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    34
    isabelle build_vscode
4400eeb6c32d updated notes on Isabelle/VSCode development;
wenzelm
parents: 73539
diff changeset
    35
    isabelle vscode --install-extension src/Tools/VSCode/extension/isabelle-1.2.2.vsix