gitea/gitea-docs
1
0
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-06-29 23:55:23 +00:00
Code Issues Packages Projects Releases Wiki Activity

CAD File Preview - Last Change (markup, spelling, script) (#201)

Browse Source 
Fixed all remaining issues (spelling mistakes, markup, etc.)

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Reviewed-on: https://gitea.com/gitea/docs/pulls/201
Reviewed-by: techknowlogick <techknowlogick@noreply.gitea.com>
Co-authored-by: recoolcz <recoolcz@noreply.gitea.com>
Co-committed-by: recoolcz <recoolcz@noreply.gitea.com>
This commit is contained in:
recoolcz
2025-04-08 15:13:15 +00:00
committed by techknowlogick
parent a6305438b9
commit 330f8b808b
1 changed files with 10 additions and 13 deletions
Download Patch File Download Diff File Expand all files Collapse all files

23
docs/administration/customizing-gitea.md
View File

@@ -165,26 +165,26 @@ Alice <-- Bob: Another authentication Response
The script will detect tags with `class="language-plantuml"`, but you can change this by providing a second argument to `parsePlantumlCodeBlocks`.
### Example: CAD Files Preview
### Example: CAD Files Preview using Online 3D Viewer
You can implement your own CAD file viewer inside your Gitea instance.
You can implement CAD file preview inside your Gitea instance. This implemenation uses [`Online 3D Viewer`](https://github.com/kovacsv/Online3DViewer).
This implementation supports 3D preview for of these file formats:
Supports following 3D file formats:
'3dm', '3ds', '3mf', 'amf', 'bim', 'brep', 'dae', 'fbx', 'fcstd', 'glb',
'gltf', 'ifc', 'igs', 'iges', 'stp', 'step', 'stl', 'obj', 'off', 'ply', 'wrl'
(Only v2 for .gltf files)
Part 1: Add template
#### Part 1: Add template
In $GITEA_CUSTOM we need to add our template.
This template needs to be saved in "$GITEA_CUSTOM/templates/custom/".
Here create file "footer.tmpl" and add following text into it:
```
```html
<script>
document.addEventListener('DOMContentLoaded', () => {
// Supported 3D file types
const fileTypes = ['3dm', '3ds', '3mf', 'amf', 'bim', 'brep', 'dae', 'fbx', 'fcstd', 'glb', 'gltf', 'ifc', 'igs', 'iges', 'step', 'stl', 'obj', 'off', 'ply', 'wrl'];
const fileTypes = ['3dm', '3ds', '3mf', 'amf', 'bim', 'brep', 'dae', 'fbx', 'fcstd', 'glb', 'gltf', 'ifc', 'igs', 'iges', 'stp'. 'step', 'stl', 'obj', 'off', 'ply', 'wrl'];
// Select matching link
const links = Array.from(document.querySelectorAll('a.ui.mini.basic.button'));
@@ -238,8 +238,7 @@ Here create file "footer.tmpl" and add following text into it:
</script>
```
Part 2: Add public files
#### Part 2: Add public files
Now we need to download latest version of O3DV. Go to "$GITEA_CUSTOM/public/assets/".
Create folder using (and cd into it):
@@ -251,6 +250,7 @@ cd o3dv
Copy latest release zip link from [`GitHub`](https://github.com/kovacsv/Online3DViewer/releases) (v0.15.0 as of now).
Here use e.g. wget to download the file:
```
wget https://github.com/kovacsv/Online3DViewer/releases/download/0.15.0/o3dv.zip
```
@@ -260,8 +260,7 @@ Use e.g. unzip to unzip the archive:
unzip o3dv.zip
```
Part 3: Folder permissions
#### Part 3: Folder permissions
Now the last thing. Change permissions on the "footer.tmpl":
```
@@ -274,7 +273,7 @@ And on the public folder:
chown -R git:git $GITEA_CUSTOM/public
```
Now we have everything ready! Restart you gitea instance to apply these changes and test it in your browser.
Now we have everything ready! Restart your gitea instance to apply these changes and test it in your browser.
You should end-up with a folder structure similar to this:
@@ -292,8 +291,6 @@ $GITEA_CUSTOM/public/assets/
\...
```
Now we have everything ready! Restart you gitea instance to apply these changes and you can test it in your browser.
## Customizing Gitea mails
The `$GITEA_CUSTOM/templates/mail` folder allows changing the body of every mail of Gitea.