{"id":21680547,"url":"https://github.com/juliapluto/static-export-template-gitlab","last_synced_at":"2025-08-10T08:44:30.732Z","repository":{"id":44700886,"uuid":"380225636","full_name":"JuliaPluto/static-export-template-gitlab","owner":"JuliaPluto","description":"Build pluto notebooks in GitLab CI/CD. https://gitlab.com/sosiristseng/static-export-template-gitlab","archived":false,"fork":false,"pushed_at":"2022-11-04T03:25:46.000Z","size":37,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-26T01:51:07.421Z","etag":null,"topics":["gitlab-ci","julia","pluto-notebooks"],"latest_commit_sha":null,"homepage":"https://sosiristseng.gitlab.io/static-export-template-gitlab","language":"Julia","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JuliaPluto.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-06-25T12:06:25.000Z","updated_at":"2022-01-28T14:41:01.000Z","dependencies_parsed_at":"2023-01-21T12:33:52.984Z","dependency_job_id":null,"html_url":"https://github.com/JuliaPluto/static-export-template-gitlab","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuliaPluto%2Fstatic-export-template-gitlab","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuliaPluto%2Fstatic-export-template-gitlab/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuliaPluto%2Fstatic-export-template-gitlab/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JuliaPluto%2Fstatic-export-template-gitlab/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JuliaPluto","download_url":"https://codeload.github.com/JuliaPluto/static-export-template-gitlab/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248526183,"owners_count":21118838,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gitlab-ci","julia","pluto-notebooks"],"created_at":"2024-11-25T15:18:15.073Z","updated_at":"2025-04-12T06:23:54.472Z","avatar_url":"https://github.com/JuliaPluto.png","language":"Julia","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Statically exporting Pluto notebooks in GitLab\n\nThis is a demo repository containing one [Pluto](https://github.com/fonsp/Pluto.jl) notebook that is **automatically converted to HTML** by GitLab CI/CD pipelines, and published to GitLab pages! 🌝\n\nThis project is forked from [static-export-template](https://github.com/JuliaPluto/static-export-template) and runs GitLab [CI/CD pipelines](https://gitlab.com/sosiristseng/static-export-template-gitlab/-/pipelines) in the [mirroring GitLAab repository](https://gitlab.com/sosiristseng/static-export-template-gitlab) to export [gitlab pages](https://sosiristseng.gitlab.io/static-export-template-gitlab).\n\nMore info here:\n\u003chttps://www.notion.so/Interactive-web-articles-bf3af6de77854660807e674148c27b1f#1a997e538e0d48e0bf54d2d5f29dfc2b\u003e\n\nThis project is at its infancy so be careful to use the code in this repository for your own projects.\n\n## Cerating a new project using this template\n\n### 👉 Step 1\n\nRegister a GitLab account if you don't have one. Add a new GitLab project by importing this repository: `https://github.com/JuliaPluto/static-export-template-gitlab.git` or the GitLab mirror `https://gitlab.com/sosiristseng/static-export-template-gitlab.git`.\n\n![image](https://user-images.githubusercontent.com/40054455/123437682-8552b200-d602-11eb-8daa-d7aaeca3eb7e.png)\n\n### 👉 Step 2\n\nClick on **Upload file** to upload your `.jl` notebook files and commit changes.\n\n![image](https://user-images.githubusercontent.com/40054455/123435949-b16d3380-d600-11eb-8597-30d324f608b8.png)\n\nYour notebooks will run on gitlab every time that you add / update the files in this repository. To check the progress, click on `CI/CD` -\u003e `Pipelines`, you will find the _jobs_ for the last commit.\n\n![image](https://user-images.githubusercontent.com/40054455/123438575-67d21800-d603-11eb-991f-84ee90b6808f.png)\n\nWait for the GitLab CI/CD to finish running your notebook and publish the HTML files to GitLab pages. The URL is available in the `Settings` -\u003e `Pages` of your repository.\n\n## Update notebook files\n\nTo update an existing notebook file, simply repeat Step 2 above! \n\nYou can also click on the file and then press **Replace** to update a file that already exists on the repository.\n\n![image](https://user-images.githubusercontent.com/40054455/123435720-73700f80-d600-11eb-9c44-7b4ad699a969.png)\n\n\n## Setup in an existing repository\n\nIf you already have a GitLab repository with some pluto notebooks in it, you may want to add a web view like the one for your repository. In that case, the steps are slightly different. In this case, I assume that you are familiar with managing a repository. If not, follow the steps above.\n\n### 👉 Step 1\n\nMake sure that all your Pluto notebooks can be run from a fresh Julia environment. See the tips below about packages.\n\n### 👉 Step 2\n\nFrom this repository, download [`.gitlab-ci.yml`](.gitlab-ci.yml) and save the file in your own repository root. Commit it to your repository.\n\n*Note: The YAML file assumes you are using `main` as the default branch. Change `main` to your default branch name in line 28 and 41 if necessary.*\n\nThe rest is the same as `👉 Step 2` in the previous section.\n\n\n## 💡Tips\n\n### Environment for the notebooks\n\nPlease see [🎁 Package management](https://github.com/fonsp/Pluto.jl/wiki/🎁-Package-management) in Pluto notebooks. (Requires Pluto 0.15+)\n\n### Homepage\n\nIf you go to the website URL of this repository, you will see a small index of the notebooks in this repository if you don't have a `index.html`. You can customize this page, two options are:\n\n- Create your own `index.html`, it will be used as the homepage.\n- Rename one of your notebooks to `index.jl`, and it will be the default notebook!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliapluto%2Fstatic-export-template-gitlab","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjuliapluto%2Fstatic-export-template-gitlab","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjuliapluto%2Fstatic-export-template-gitlab/lists"}