Skip to content

Commit d28c9cf

Browse files
Rodrigoplp-workRodrigoplp-work
committed
Website for Theia Trace Extension documentation
Adds a website in the "doc" folder to hold the documentation for Theia Trace Extension. Website built with [Svelte Kit](https://kit.svelte.dev). This PR replaces eclipse-cdt-cloud#776, which accomplishes the same goal but uses GatsbyJS. The proposal to replace Gatsby with Svelte aims at reducing the code base and adopting more modern solutions for the problem of rendering static documentation sites. Signed-off-by: Rodrigo Pinto ([email protected])
1 parent 0e40ac1 commit d28c9cf

File tree

15 files changed

+1329
-0
lines changed

15 files changed

+1329
-0
lines changed

‎doc/web-doc/.eslintignore‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
.DS_Store
2+
node_modules
3+
/build
4+
/.svelte-kit
5+
/package
6+
.env
7+
.env.*
8+
!.env.example
9+
10+
# Ignore files for PNPM, NPM and YARN
11+
pnpm-lock.yaml
12+
package-lock.json
13+
yarn.lock

‎doc/web-doc/.eslintrc.cjs‎

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
module.exports = {
2+
root: true,
3+
extends: ['eslint:recommended', 'prettier'],
4+
plugins: ['svelte3'],
5+
overrides: [{ files: ['*.svelte'], processor: 'svelte3/svelte3' }],
6+
parserOptions: {
7+
sourceType: 'module',
8+
ecmaVersion: 2020
9+
},
10+
env: {
11+
browser: true,
12+
es2017: true,
13+
node: true
14+
}
15+
};

‎doc/web-doc/.gitignore‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
.DS_Store
2+
node_modules
3+
/build
4+
/.svelte-kit
5+
/package
6+
.env
7+
.env.*
8+
!.env.example
9+
vite.config.js.timestamp-*
10+
vite.config.ts.timestamp-*

‎doc/web-doc/.prettierignore‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
.DS_Store
2+
node_modules
3+
/build
4+
/.svelte-kit
5+
/package
6+
.env
7+
.env.*
8+
!.env.example
9+
10+
# Ignore files for PNPM, NPM and YARN
11+
pnpm-lock.yaml
12+
package-lock.json
13+
yarn.lock

‎doc/web-doc/.prettierrc‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
{
2+
"useTabs": true,
3+
"singleQuote": true,
4+
"trailingComma": "none",
5+
"printWidth": 100,
6+
"plugins": ["prettier-plugin-svelte"],
7+
"pluginSearchDirs": ["."],
8+
"overrides": [{ "files": "*.svelte", "options": { "parser": "svelte" } }]
9+
}

‎doc/web-doc/README.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Documentation framework for Theia Trace Extension
2+
3+
## Installation
4+
5+
```bash
6+
cd doc/web-doc
7+
yarn
8+
```
9+
10+
Run site
11+
12+
```bash
13+
yarn dev
14+
15+
# or start the server and open the app in a new browser tab
16+
yarn dev -- --open
17+
```
18+
19+
The site will be running at `http://localhost:5173`.
20+
21+
## Code style
22+
23+
Run Prettier from the root.
24+
25+
Check code style:
26+
27+
yarn lint
28+
29+
Fix code style:
30+
31+
yarn format
32+
33+
## Development
34+
35+
Website created with [SvelteKit](https://kit.svelte.dev)

‎doc/web-doc/package.json‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
{
2+
"name": "web-doc",
3+
"version": "0.0.1",
4+
"private": true,
5+
"scripts": {
6+
"dev": "vite dev",
7+
"build": "vite build",
8+
"preview": "vite preview",
9+
"lint": "prettier --plugin-search-dir . --check . && eslint .",
10+
"format": "prettier --plugin-search-dir . --write ."
11+
},
12+
"devDependencies": {
13+
"@sveltejs/adapter-auto": "^1.0.0",
14+
"@sveltejs/kit": "^1.0.0",
15+
"eslint": "^8.28.0",
16+
"eslint-config-prettier": "^8.5.0",
17+
"eslint-plugin-svelte3": "^4.0.0",
18+
"prettier": "^2.8.0",
19+
"prettier-plugin-svelte": "^2.8.1",
20+
"svelte": "^3.54.0",
21+
"vite": "^4.0.0"
22+
},
23+
"type": "module"
24+
}

‎doc/web-doc/src/app.html‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
<!DOCTYPE html>
2+
<html lang="en">
3+
<head>
4+
<meta charset="utf-8" />
5+
<link rel="icon" href="%sveltekit.assets%/favicon.png" />
6+
<meta name="viewport" content="width=device-width" />
7+
%sveltekit.head%
8+
</head>
9+
<body data-sveltekit-preload-data="hover">
10+
<div style="display: contents">%sveltekit.body%</div>
11+
</body>
12+
</html>

‎doc/web-doc/src/routes/+layout.svelte‎

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
<script>
2+
import Header from '$lib/components/Header.svelte';
3+
import Sidebar from '$lib/components/Sidebar.svelte';
4+
</script>
5+
6+
<div class="app">
7+
<Header />
8+
9+
<main>
10+
<div class="content">
11+
<Sidebar />
12+
<div class="inner-page">
13+
<slot />
14+
</div>
15+
</div>
16+
</main>
17+
18+
<footer>
19+
<p>
20+
<a href="https://github.com/eclipse-cdt-cloud/theia-trace-extension">Theia Trace Extension</a>
21+
</p>
22+
</footer>
23+
</div>
24+
25+
<style>
26+
.app {
27+
display: flex;
28+
flex-direction: column;
29+
min-height: 100vh;
30+
}
31+
32+
.content {
33+
flex: 1;
34+
display: flex;
35+
flex-direction: row;
36+
}
37+
38+
main {
39+
flex: 1;
40+
display: flex;
41+
flex-direction: column;
42+
padding: 1rem;
43+
width: 100%;
44+
max-width: 64rem;
45+
margin: 0 auto;
46+
box-sizing: border-box;
47+
}
48+
49+
.inner-page {
50+
flex: 1;
51+
display: flex;
52+
flex-direction: column;
53+
}
54+
55+
footer {
56+
display: flex;
57+
flex-direction: column;
58+
justify-content: center;
59+
align-items: center;
60+
padding: 12px;
61+
}
62+
63+
footer a {
64+
font-weight: bold;
65+
}
66+
67+
@media (min-width: 480px) {
68+
footer {
69+
padding: 12px 0;
70+
}
71+
}
72+
</style>

‎doc/web-doc/src/routes/+page.svelte‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
<script>
2+
import tteImage from '$lib/images/theia-trace-extension-0.0.3.png';
3+
</script>
4+
5+
<div class="content">
6+
<h1>Welcome to Theia Trace Extension</h1>
7+
<img src={tteImage} alt="Trace Compass" />
8+
</div>
9+
10+
<style>
11+
.content {
12+
text-align: center;
13+
}
14+
15+
img {
16+
width: 40em;
17+
}
18+
</style>

0 commit comments

Comments
 (0)