tutorials:5
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionLast revisionBoth sides next revision | ||
tutorials:5 [2022/09/26 23:12] – created - external edit 127.0.0.1 | tutorials:5 [2023/04/03 13:22] – created tcmal | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | ====== 5. Making a custom homepage ====== | ||
+ | As part of your Tardis account, you get your own subdomain at ''< | ||
+ | |||
+ | For now, let's start by making a static homepage (one that doesn' | ||
+ | |||
+ | We're going to assume a little bit of familiarity with Git, but not much with GitLab. Check the links [[tutorials: | ||
+ | |||
+ | ===== Logging into GitLab and making a repository ===== | ||
+ | |||
+ | Head over to https:// | ||
+ | |||
+ | We'll start with a blank project so we can learn - make sure your project name is ''< | ||
+ | |||
+ | ===== Setting up an SSH key ===== | ||
+ | |||
+ | Now we have our repository, we want to clone it locally. To do this, we need to authenticate to Gitlab in a way it understands - we'll use SSH keys because they' | ||
+ | |||
+ | In a terminal, run '' | ||
+ | |||
+ | Now run '' | ||
+ | |||
+ | Now we can use our SSH key to authenticate to Gitlab. Behind the scenes, this is using public-key cryptography. | ||
+ | |||
+ | ===== Cloning the repository ===== | ||
+ | |||
+ | Go back to the project you've just created and click the blue ' | ||
+ | |||
+ | Go to your command line and type '' | ||
+ | |||
+ | ===== Making a homepage ===== | ||
+ | |||
+ | For now, we're just going to make a simple homepage using HTML. Create a folder named '' | ||
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | You should come back and edit this later, adding whatever content you want. | ||
+ | |||
+ | ===== Telling GitLab it's a homepage ===== | ||
+ | |||
+ | Now we have our ' | ||
+ | |||
+ | Create a new file called '' | ||
+ | |||
+ | < | ||
+ | image: alpine: | ||
+ | pages: | ||
+ | stage: deploy | ||
+ | script: | ||
+ | - echo ' | ||
+ | artifacts: | ||
+ | paths: | ||
+ | - public | ||
+ | only: | ||
+ | - main | ||
+ | </ | ||
+ | |||
+ | If you're not familiar, this file is used to specify CI steps, which can be used for automatically testing or deploying code when it's pushed to Gitlab. | ||
+ | |||
+ | Here, we're only defining one thing to do: ' | ||
+ | |||
+ | ' | ||
+ | |||
+ | ===== More ===== | ||
+ | |||
+ | We've just used plain HTML - if this is new to you then consider learning HTML, CSS, and JS - they' | ||
+ | |||
+ | If you don't want to keep writing HTML, consider using some kind of static site generator: | ||
+ | |||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | * [[https:// | ||
+ | |||
+ | [[https:// | ||
+ | |||
+ | As we've mentioned, Gitlab CI can be configured to run any command, so you could even make your own custom scripts to do this - [[https:// | ||
+ | |||
+ | Also note that you can have multiple repositories - If you do this with a repo called '' |