README improvements
This commit is contained in:
parent
01ff89eea3
commit
4f8e61322f
79
.assets/zls.svg
Normal file
79
.assets/zls.svg
Normal file
@ -0,0 +1,79 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
|
||||||
|
<svg
|
||||||
|
xmlns:dc="http://purl.org/dc/elements/1.1/"
|
||||||
|
xmlns:cc="http://creativecommons.org/ns#"
|
||||||
|
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
|
||||||
|
xmlns:svg="http://www.w3.org/2000/svg"
|
||||||
|
xmlns="http://www.w3.org/2000/svg"
|
||||||
|
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
|
||||||
|
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
|
||||||
|
sodipodi:docname="zls.svg"
|
||||||
|
inkscape:version="1.0 (4035a4fb49, 2020-05-01)"
|
||||||
|
id="svg8"
|
||||||
|
version="1.1"
|
||||||
|
viewBox="0 0 140.22915 82.020839"
|
||||||
|
height="310"
|
||||||
|
width="530">
|
||||||
|
<defs
|
||||||
|
id="defs2" />
|
||||||
|
<sodipodi:namedview
|
||||||
|
units="px"
|
||||||
|
inkscape:window-maximized="1"
|
||||||
|
inkscape:window-y="-6"
|
||||||
|
inkscape:window-x="1700"
|
||||||
|
inkscape:window-height="898"
|
||||||
|
inkscape:window-width="1707"
|
||||||
|
showgrid="false"
|
||||||
|
inkscape:document-rotation="0"
|
||||||
|
inkscape:current-layer="layer1"
|
||||||
|
inkscape:document-units="mm"
|
||||||
|
inkscape:cy="334.80457"
|
||||||
|
inkscape:cx="588.82098"
|
||||||
|
inkscape:zoom="0.49497475"
|
||||||
|
inkscape:pageshadow="2"
|
||||||
|
inkscape:pageopacity="0.0"
|
||||||
|
borderopacity="1.0"
|
||||||
|
bordercolor="#666666"
|
||||||
|
pagecolor="#ffffff"
|
||||||
|
id="base" />
|
||||||
|
<metadata
|
||||||
|
id="metadata5">
|
||||||
|
<rdf:RDF>
|
||||||
|
<cc:Work
|
||||||
|
rdf:about="">
|
||||||
|
<dc:format>image/svg+xml</dc:format>
|
||||||
|
<dc:type
|
||||||
|
rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
|
||||||
|
<dc:title></dc:title>
|
||||||
|
</cc:Work>
|
||||||
|
</rdf:RDF>
|
||||||
|
</metadata>
|
||||||
|
<g
|
||||||
|
id="layer1"
|
||||||
|
inkscape:groupmode="layer"
|
||||||
|
inkscape:label="Layer 1">
|
||||||
|
<text
|
||||||
|
id="text967"
|
||||||
|
y="26.192413"
|
||||||
|
x="8.5526314"
|
||||||
|
style="font-style:normal;font-weight:normal;font-size:25.4px;line-height:0.9;font-family:sans-serif;letter-spacing:-2.64583px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;stroke-width:0.264583"
|
||||||
|
xml:space="preserve"><tspan
|
||||||
|
sodipodi:role="line"
|
||||||
|
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:25.4px;font-family:Inter;-inkscape-font-specification:'Inter Bold';letter-spacing:0px;fill:#000000;fill-opacity:1;stroke-width:0.264583"
|
||||||
|
y="26.192413"
|
||||||
|
x="8.5526314"
|
||||||
|
id="tspan965"><tspan
|
||||||
|
id="tspan971"
|
||||||
|
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-family:Inter;-inkscape-font-specification:'Inter Bold';fill:#f7a41d;fill-opacity:1">Zig</tspan></tspan><tspan
|
||||||
|
id="tspan977"
|
||||||
|
sodipodi:role="line"
|
||||||
|
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:25.4px;font-family:Inter;-inkscape-font-specification:'Inter Bold';letter-spacing:0px;fill:#000000;fill-opacity:1;stroke-width:0.264583"
|
||||||
|
y="49.386147"
|
||||||
|
x="8.5526314">Language</tspan><tspan
|
||||||
|
id="tspan984"
|
||||||
|
sodipodi:role="line"
|
||||||
|
style="font-style:normal;font-variant:normal;font-weight:bold;font-stretch:normal;font-size:25.4px;font-family:Inter;-inkscape-font-specification:'Inter Bold';letter-spacing:0px;fill:#000000;fill-opacity:1;stroke-width:0.264583"
|
||||||
|
y="72.57988"
|
||||||
|
x="8.5526314">Server</tspan></text>
|
||||||
|
</g>
|
||||||
|
</svg>
|
After Width: | Height: | Size: 3.1 KiB |
24
README.md
24
README.md
@ -1,21 +1,39 @@
|
|||||||
# zls - Zig Language Server
|
![Zig Language Server](https://raw.githubusercontent.com/SuperAuguste/zls/master/.assets/zls.svg)
|
||||||
|
|
||||||
Zig Language Server (or `zls` for short) is a - you guessed it - language server for Zig! Based off of the code written by the great `andersfr`.
|
Zig Language Server, or `zls`, is a language server for Zig. The Zig wiki states that "The Zig community is decentralized" and "There is no concept of 'official' or 'unofficial'", so instead of calling `zls` unofficial, and I'm going to call it a cool option, one of [many](https://github.com/search?q=zig+language+server).
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
|
Installation `zls` is pretty simple;
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/SuperAuguste/zls
|
git clone https://github.com/SuperAuguste/zls
|
||||||
cd zls
|
cd zls
|
||||||
zig build
|
zig build
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Build Options
|
||||||
|
|
||||||
|
| Option | Type | What it Does |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `-Dno_snippets` | `bool` | Enables "no snippets" mode for compatibility with language clients that do not support snippets (such as ale). |
|
||||||
|
| `-Ddata_version` | `string` | The data file version. Any files in the `src/data` file that correspond with the Zig version you want the language server to build for (0.6.0, master).
|
||||||
|
|
||||||
Then, you can use the `zls` executable in an editor of your choice that has a Zig language server client!
|
Then, you can use the `zls` executable in an editor of your choice that has a Zig language server client!
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
**Please, I beg you, please don't use this unless you're developing or testing it!**
|
`zls` is in its early stages, with a full analysis/completion engine coming soon, but it is still usable.
|
||||||
|
|
||||||
### VSCode
|
### VSCode
|
||||||
|
|
||||||
Install the `zig-lsc` extension from [here](https://github.com/SuperAuguste/zig-lsc).
|
Install the `zig-lsc` extension from [here](https://github.com/SuperAuguste/zig-lsc).
|
||||||
|
|
||||||
|
|
||||||
|
## Related Projects
|
||||||
|
- [`sublime-zig-language` by @prime31](https://github.com/prime31/sublime-zig-language)
|
||||||
|
- Supports basic language features
|
||||||
|
- Uses data provided by `src/data` to perform builtin autocompletion
|
||||||
|
|
||||||
|
## License
|
||||||
|
MIT
|
||||||
|
Loading…
Reference in New Issue
Block a user