github-starred/gitea
2
0
Fork 0
mirror of https://github.com/go-gitea/gitea.git synced 2026-07-16 04:42:51 -05:00
Code Issues 2.6k Packages Projects Releases 100 Wiki Activity

view STL files #2870

New Issue
Closed
opened 2025-11-02 04:52:00 -06:00 by GiteaMirror · 16 comments
GiteaMirror commented 2025-11-02 04:52:00 -06:00
Owner
Copy Link

Originally created by @a7hybnj2 on GitHub (Feb 6, 2019).

Description

feature request: view, see, and track changes (visually) with .stl and other 3d files. (like github does)

Thanks!

I find this an amazing feature that github has and it would be even more amazing if gitea could implement similar functionality.

screen shot 2019-02-06 at 12 21 38
Originally created by @a7hybnj2 on GitHub (Feb 6, 2019). ## Description feature request: view, see, and track changes (visually) with .stl and other 3d files. (like github does) Thanks! I find this an amazing feature that github has and it would be even more amazing if gitea could implement similar functionality. <img width="819" alt="screen shot 2019-02-06 at 12 21 38" src="https://user-images.githubusercontent.com/36831279/52360349-cb932080-2a09-11e9-93e8-6263e7bea620.png">
GiteaMirror added the type/proposal label 2025-11-02 04:52:00 -06:00
GiteaMirror commented 2025-11-02 04:52:01 -06:00
Author
Owner
Copy Link

@lunny commented on GitHub (Feb 7, 2019):

Maybe you can do it via third-party tools and add some config on app.ini

@lunny commented on GitHub (Feb 7, 2019): Maybe you can do it via third-party tools and add some config on app.ini
GiteaMirror commented 2025-11-02 04:52:01 -06:00
Author
Owner
Copy Link

@a7hybnj2 commented on GitHub (Jul 23, 2019):

If anyone has had success with third-party tools let me know. I would gladly try it out but I have no idea where to even start.

Thanks.

@a7hybnj2 commented on GitHub (Jul 23, 2019): If anyone has had success with third-party tools let me know. I would gladly try it out but I have no idea where to even start. Thanks.
GiteaMirror commented 2025-11-02 04:52:01 -06:00
Author
Owner
Copy Link

@lunny commented on GitHub (Jul 23, 2019):

At first, are there any command line tools or scripts could convert the files to HTML files?

@lunny commented on GitHub (Jul 23, 2019): At first, are there any command line tools or scripts could convert the files to HTML files?
GiteaMirror commented 2025-11-02 04:52:01 -06:00
Author
Owner
Copy Link

@sapk commented on GitHub (Jul 24, 2019):

How do you run gitea ? on windows, linux, ... ? Do you use the docker image ?

@sapk commented on GitHub (Jul 24, 2019): How do you run gitea ? on windows, linux, ... ? Do you use the docker image ?
GiteaMirror commented 2025-11-02 04:52:01 -06:00
Author
Owner
Copy Link

@sapk commented on GitHub (Jul 24, 2019):

I have a script that can render .scad and .stl file but it will need openscad that may not be easily installable depending of your installation https://gist.github.com/sapk/ce1c246dd39a5f434554b31d0ca8ecdb

@sapk commented on GitHub (Jul 24, 2019): I have a script that can render .scad and .stl file but it will need openscad that may not be easily installable depending of your installation https://gist.github.com/sapk/ce1c246dd39a5f434554b31d0ca8ecdb
GiteaMirror commented 2025-11-02 04:52:02 -06:00
Author
Owner
Copy Link

@a7hybnj2 commented on GitHub (Jul 24, 2019):

@sapk I am running in a freebsd jail installed with ports.

I will take a look at that script but it seems like a static render...right?

github does this: https://imgur.com/a/eZxCIHI which is amazing. It also highlights the parts of the STLs when you look at the commit diffs...

@a7hybnj2 commented on GitHub (Jul 24, 2019): @sapk I am running in a freebsd jail installed with ports. I will take a look at that script but it seems like a static render...right? github does this: https://imgur.com/a/eZxCIHI which is amazing. It also highlights the parts of the STLs when you look at the commit diffs...
GiteaMirror commented 2025-11-02 04:52:02 -06:00
Author
Owner
Copy Link

@lafriks commented on GitHub (Jul 24, 2019):

We could use something like this: https://github.com/kaitlynhova/Three.js-STL-Viewer

@lafriks commented on GitHub (Jul 24, 2019): We could use something like this: https://github.com/kaitlynhova/Three.js-STL-Viewer
GiteaMirror commented 2025-11-02 04:52:02 -06:00
Author
Owner
Copy Link

@sapk commented on GitHub (Jul 24, 2019):

@lafriks there is various JS lib mostly all not maintained. The more advanced I found is https://github.com/kovacsv/Online3DViewer I feel like we should not support it but allow the use of direct HTML (no sanitize) via external render if requested by option (and add libs under public).

@sapk commented on GitHub (Jul 24, 2019): @lafriks there is various JS lib mostly all not maintained. The more advanced I found is https://github.com/kovacsv/Online3DViewer I feel like we should not support it but allow the use of direct HTML (no sanitize) via external render if requested by option (and add libs under public).
GiteaMirror commented 2025-11-02 04:52:02 -06:00
Author
Owner
Copy Link

@zeripath commented on GitHub (Jul 24, 2019):

Would it be better to still in general sanitise but allow an external renderer to add some standard page sections?

@zeripath commented on GitHub (Jul 24, 2019): Would it be better to still in general sanitise but allow an external renderer to add some standard page sections?
GiteaMirror commented 2025-11-02 04:52:03 -06:00
Author
Owner
Copy Link

@vmario89 commented on GitHub (Jan 15, 2020):

i am looking for the same feature because i am doing tons of open hardware stuff with git. the github feature to render STL is really nice but i think github blows up and slows down. so need and want to host viewable cad files with clean versioning for my own. i am running gitea for a year now.

maybe the stl feature could be done with Githubiverse templates and if another missing feature 'pages' would be there:

@vmario89 commented on GitHub (Jan 15, 2020): i am looking for the same feature because i am doing tons of open hardware stuff with git. the github feature to render STL is really nice but i think github blows up and slows down. so need and want to host viewable cad files with clean versioning for my own. i am running gitea for a year now. maybe the stl feature could be done with Githubiverse templates and if another missing feature 'pages' would be there: - https://github.com/cscott/thing-tracker - https://github.com/garyhodgson/githubiverse-template - https://github.com/garyhodgson/thing-tracker-site-template
GiteaMirror commented 2025-11-02 04:52:03 -06:00
Author
Owner
Copy Link

@dsmrs commented on GitHub (Feb 22, 2020):

at Github they use Three.js for the STL viewer.
We could indeed use https://github.com/kovacsv/Online3DViewer it seems to be the more active open-source STL online viewer.

The process for the diff is explained here: https://github.blog/2013-09-17-3d-file-diffs/ Not a 3D expert, but it doesn't look that complex no? (but CPU/GPU consuming for the gitea server).

@dsmrs commented on GitHub (Feb 22, 2020): at Github they use [Three.js](http://threejs.org/) for the STL viewer. We could indeed use https://github.com/kovacsv/Online3DViewer it seems to be the more active open-source STL online viewer. The process for the diff is explained here: https://github.blog/2013-09-17-3d-file-diffs/ Not a 3D expert, but it doesn't look that complex no? (but CPU/GPU consuming for the gitea server).
GiteaMirror commented 2025-11-02 04:52:03 -06:00
Author
Owner
Copy Link

@vmario89 commented on GitHub (Aug 18, 2020):

gitea added this feature in documentation. i integrated madeleine.js (three.js wrapper) into our environent succesfully. i had to adjust some things to make it render with complete width on smarthpones and computers (tested with firefox and chrome)

grafik

https://gitea.fablabchemnitz.de/MarioVoigt/Madeleine.js-for-Gitea

happy for more fixes to make it clean.

the docs for integration are provided here: https://docs.gitea.io/en-us/customizing-gitea/

@vmario89 commented on GitHub (Aug 18, 2020): gitea added this feature in documentation. i integrated madeleine.js (three.js wrapper) into our environent succesfully. i had to adjust some things to make it render with complete width on smarthpones and computers (tested with firefox and chrome) ![grafik](https://user-images.githubusercontent.com/5631071/90552157-b10b3d00-e192-11ea-9f62-b055c6d8ad0f.png) https://gitea.fablabchemnitz.de/MarioVoigt/Madeleine.js-for-Gitea happy for more fixes to make it clean. the docs for integration are provided here: https://docs.gitea.io/en-us/customizing-gitea/
GiteaMirror commented 2025-11-02 04:52:03 -06:00
Author
Owner
Copy Link

@Codeberg-org commented on GitHub (Aug 24, 2020):

FWIW an alternative STL previewer based rendering directly with three.js has been implemented in https://codeberg.org/Codeberg/build-deploy-gitea/pulls/31 -- we believe controls are a bit more intuitive (especially on mobile, also no gimbal lock in rotation; trackball-style control). Implementation is a single JS file, but threejs is added as dependency.

Try and visit: https://codeberg.org/Codeberg/three.js/src/branch/dev/examples/models/stl/binary/colored.stl

@Codeberg-org commented on GitHub (Aug 24, 2020): FWIW an alternative STL previewer based rendering directly with three.js has been implemented in https://codeberg.org/Codeberg/build-deploy-gitea/pulls/31 -- we believe controls are a bit more intuitive (especially on mobile, also no gimbal lock in rotation; trackball-style control). Implementation is a single JS file, but threejs is added as dependency. Try and visit: https://codeberg.org/Codeberg/three.js/src/branch/dev/examples/models/stl/binary/colored.stl
GiteaMirror commented 2025-11-02 04:52:04 -06:00
Author
Owner
Copy Link

@a7hybnj2 commented on GitHub (Aug 24, 2020):

@vmario89 I tried to get madeleine.js up and running and it isn't working. Here is my setup:

git@raspberrypi:~/gitea/custom/templates/custom $ la
-rw-r--r-- 1 git git  868 Aug 24 18:12 footer.tmpl
git@raspberrypi:~/gitea/custom/templates/custom $ cat footer.tmpl 
<script>
function lS(src){
  return new Promise(function(resolve, reject) {
    let s = document.createElement('script')
    s.src = src
    s.addEventListener('load', () => {
      resolve()
    })
    document.body.appendChild(s)
  });
}

if($('.view-raw>a[href$=".stl" i]').length){
  $('body').append('<link href="/Madeleine.js/src/css/Madeleine.css" rel="stylesheet">');
  Promise.all([lS("/Madeleine.js/src/lib/stats.js"),lS("/Madeleine.js/src/lib/detector.js"), lS("/Madeleine.js/src/lib/three.min.js"), lS("/Madeleine.js/src/Madeleine.js")]).then(function() {
    $('.view-raw').attr('id', 'view-raw').attr('style', 'padding: 0;margin-bottom: -10px;');
    new Madeleine({
      target: 'view-raw',
      data: $('.view-raw>a[href$=".stl" i]').attr('href'),
      path: '/Madeleine.js/src'
    });
    $('.view-raw>a[href$=".stl"]').remove()
  });
}
</script>


git@raspberrypi:~/gitea/custom/public/Madeleine.js $ la
drwxr-xr-x 2 git git 4096 Dec 17  2019 css
drwxr-xr-x 2 git git 4096 Dec 17  2019 examples
drwxr-xr-x 2 git git 4096 Dec 17  2019 images
-rwxr-xr-x 1 git git 1077 Dec 17  2019 LICENSE
drwxr-xr-x 2 git git 4096 Dec 17  2019 models
-rwxr-xr-x 1 git git 3223 Dec 17  2019 README.md
drwxr-xr-x 5 git git 4096 Dec 17  2019 src

public and templates/custom folders were not present inside the custom directory so I created them.
I restarted the gitea service.
I am using an .stl that I generated from an openScad project and I just see the 'raw' text.

any thoughts to help get this up and running?

additional maybe helpful data I pulled from site admin - config

Repository Root Path
    /home/git/gitea-repositories
Static File Root Path
    /home/git/gitea
Custom File Root Path
    /home/git/gitea/custom
Log Path
    /home/git/gitea/log
Script Type
    bash
Reverse Authentication User
    X-WEBAUTH-USER
@a7hybnj2 commented on GitHub (Aug 24, 2020): @vmario89 I tried to get madeleine.js up and running and it isn't working. Here is my setup: ``` git@raspberrypi:~/gitea/custom/templates/custom $ la -rw-r--r-- 1 git git 868 Aug 24 18:12 footer.tmpl git@raspberrypi:~/gitea/custom/templates/custom $ cat footer.tmpl <script> function lS(src){ return new Promise(function(resolve, reject) { let s = document.createElement('script') s.src = src s.addEventListener('load', () => { resolve() }) document.body.appendChild(s) }); } if($('.view-raw>a[href$=".stl" i]').length){ $('body').append('<link href="/Madeleine.js/src/css/Madeleine.css" rel="stylesheet">'); Promise.all([lS("/Madeleine.js/src/lib/stats.js"),lS("/Madeleine.js/src/lib/detector.js"), lS("/Madeleine.js/src/lib/three.min.js"), lS("/Madeleine.js/src/Madeleine.js")]).then(function() { $('.view-raw').attr('id', 'view-raw').attr('style', 'padding: 0;margin-bottom: -10px;'); new Madeleine({ target: 'view-raw', data: $('.view-raw>a[href$=".stl" i]').attr('href'), path: '/Madeleine.js/src' }); $('.view-raw>a[href$=".stl"]').remove() }); } </script> ``` ``` git@raspberrypi:~/gitea/custom/public/Madeleine.js $ la drwxr-xr-x 2 git git 4096 Dec 17 2019 css drwxr-xr-x 2 git git 4096 Dec 17 2019 examples drwxr-xr-x 2 git git 4096 Dec 17 2019 images -rwxr-xr-x 1 git git 1077 Dec 17 2019 LICENSE drwxr-xr-x 2 git git 4096 Dec 17 2019 models -rwxr-xr-x 1 git git 3223 Dec 17 2019 README.md drwxr-xr-x 5 git git 4096 Dec 17 2019 src ``` `public` and `templates/custom` folders were not present inside the `custom` directory so I created them. I restarted the gitea service. I am using an .stl that I generated from an openScad project and I just see the 'raw' text. any thoughts to help get this up and running? additional maybe helpful data I pulled from `site admin - config` ``` Repository Root Path /home/git/gitea-repositories Static File Root Path /home/git/gitea Custom File Root Path /home/git/gitea/custom Log Path /home/git/gitea/log Script Type bash Reverse Authentication User X-WEBAUTH-USER ```
GiteaMirror commented 2025-11-02 04:52:04 -06:00
Author
Owner
Copy Link

@vmario89 commented on GitHub (Aug 28, 2020):

Hey,

i documented it for myself some weeks ago the following (hopefully correct):

cd /opt/gitea/custom/templates/
mkdir base/
cd base/
vim /opt/gitea/custom/templates/base/footer.tmpl

<script>
function lS(src){
  return new Promise(function(resolve, reject) {
    let s = document.createElement('script')
    s.src = src
    s.addEventListener('load', () => {
      resolve()
    })
    document.body.appendChild(s)
  });
}
 
if($('.view-raw>a[href$=".stl" i]').length){
  $('body').append('<link href="/Madeleine.js/src/css/Madeleine.css" rel="stylesheet">');
  Promise.all([lS("/Madeleine.js/src/lib/stats.js"),lS("/Madeleine.js/src/lib/detector.js"), lS("/Madeleine.js/src/lib/three.min.js"), lS("/Madeleine.js/src/Madeleine.js")]).then(function() {
    $('.view-raw').attr('id', 'view-raw').attr('style', 'padding: 0;margin-bottom: -10px;');
    new Madeleine({
      target: 'view-raw',
      data: $('.view-raw>a[href$=".stl" i]').attr('href'),
      path: '/Madeleine.js/src'
    });
    $('.view-raw>a[href$=".stl"]').remove()
  });
}
</script>

chown git:git footer.tmpl
chmod 770 footer.tmpl

cd /opt/gitea/custom/
mkdir public/
cd public/
git clone https://github.com/JinJunho/Madeleine.js.git Madeleine.js/
chown -R git:git /opt/gitea/custom/public

service gitea restart

Check your browser's console output for possible css/js/whatever errors :-)

@vmario89 commented on GitHub (Aug 28, 2020): Hey, i documented it for myself some weeks ago the following (hopefully correct): ``` cd /opt/gitea/custom/templates/ mkdir base/ cd base/ vim /opt/gitea/custom/templates/base/footer.tmpl ``` ``` <script> function lS(src){ return new Promise(function(resolve, reject) { let s = document.createElement('script') s.src = src s.addEventListener('load', () => { resolve() }) document.body.appendChild(s) }); } if($('.view-raw>a[href$=".stl" i]').length){ $('body').append('<link href="/Madeleine.js/src/css/Madeleine.css" rel="stylesheet">'); Promise.all([lS("/Madeleine.js/src/lib/stats.js"),lS("/Madeleine.js/src/lib/detector.js"), lS("/Madeleine.js/src/lib/three.min.js"), lS("/Madeleine.js/src/Madeleine.js")]).then(function() { $('.view-raw').attr('id', 'view-raw').attr('style', 'padding: 0;margin-bottom: -10px;'); new Madeleine({ target: 'view-raw', data: $('.view-raw>a[href$=".stl" i]').attr('href'), path: '/Madeleine.js/src' }); $('.view-raw>a[href$=".stl"]').remove() }); } </script> ``` ``` chown git:git footer.tmpl chmod 770 footer.tmpl ``` ``` cd /opt/gitea/custom/ mkdir public/ cd public/ git clone https://github.com/JinJunho/Madeleine.js.git Madeleine.js/ chown -R git:git /opt/gitea/custom/public ``` ``` service gitea restart ``` Check your browser's console output for possible css/js/whatever errors :-)
GiteaMirror commented 2025-11-02 04:52:04 -06:00
Author
Owner
Copy Link

@sapk commented on GitHub (Nov 1, 2020):

I will close this issue as it can be setup by many ways and at least one is in docs.
Feel free to comment or open an new issue for more specific case or come on the discord to discuss it.

@sapk commented on GitHub (Nov 1, 2020): I will close this issue as it can be setup by many ways and at least one is in docs. Feel free to comment or open an new issue for more specific case or come on the discord to discuss it.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
$20
$250
$50
$500
backport/done
💎 Bounty
docs-update-needed
good first issue
hacktoberfest
issue/bounty
issue/confirmed
issue/critical
issue/duplicate
issue/needs-feedback
issue/not-a-bug
issue/regression
issue/stale
issue/workaround
lgtm/need 2
modifies/api
modifies/translation
outdated/backport/v1.18
outdated/theme/markdown
outdated/theme/timetracker
performance/bigrepo
performance/cpu
performance/memory
performance/speed
pr/breaking
proposal/accepted
proposal/rejected
pr/wip
pull-request
Mirrored from GitHub Pull Request
 reviewed/wontfix
💰 Rewarded
skip-changelog
status/blocked
topic/accessibility
topic/api
topic/authentication
topic/build
topic/code-linting
topic/commit-signing
topic/content-rendering
topic/deployment
topic/distribution
topic/federation
topic/gitea-actions
topic/issues
topic/lfs
topic/mobile
topic/moderation
topic/packages
topic/pr
topic/projects
topic/repo
topic/repo-migration
topic/security
topic/theme
topic/ui
topic/ui-interaction
topic/ux
topic/webhooks
topic/wiki
type/bug
type/deprecation
type/docs
type/enhancement
type/feature
type/miscellaneous
type/proposal
type/question
type/refactoring
type/summary
type/testing
type/upstream
No Label type/proposal
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/gitea#2870
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?