|
1 | 1 | # agarnung.github.io |
2 | | -My (Github) webpage |
| 2 | + |
| 3 | +This portfolio is based on [portfolYOU](https://github.com/yousinix/portfolYOU/tree/master?tab=readme-ov-file). |
| 4 | + |
| 5 | +--- |
| 6 | + |
| 7 | +## Instructions for creating a portfolio with Jekyll and Bundler |
| 8 | + |
| 9 | +### 1. Install Jekyll to test the website |
| 10 | + |
| 11 | +Follow the official installation instructions for [Jekyll on Ubuntu](https://jekyllrb.com/docs/installation/ubuntu/) and for [testing GitHub Pages sites with Jekyll locally](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll). |
| 12 | + |
| 13 | +#### Steps: |
| 14 | + |
| 15 | +1. Install the necessary dependencies: |
| 16 | + ```bash |
| 17 | + sudo apt-get install ruby-full build-essential zlib1g-dev |
| 18 | + ``` |
| 19 | +2. Set up the environment to install Ruby gems in your user directory: |
| 20 | + ```bash |
| 21 | + echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc |
| 22 | + echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc |
| 23 | + echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc |
| 24 | + source ~/.bashrc |
| 25 | + ``` |
| 26 | +3. Install Jekyll and Bundler. If you run into permission issues, use sudo gem install jekyll bundler, although installing gems locally (without sudo) is preferred: |
| 27 | + ```bash |
| 28 | + gem install jekyll bundler |
| 29 | + ``` |
| 30 | +4. Verify that Jekyll and Bundler are correctly installed: |
| 31 | + ```bash |
| 32 | + jekyll --version |
| 33 | + ``` |
| 34 | +If Bundler isn't installed, follow the instructions on [GeeksforGeeks](https://www.geeksforgeeks.org/how-to-install-ruby-bundler-on-linux/). |
| 35 | + |
| 36 | +Further problems? Keep reading... |
| 37 | + |
| 38 | +### 2) Launch Jekyll and test the website |
| 39 | + |
| 40 | +Follow the official instructions to test GitHub Pages sites with [Jekyll](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll). |
| 41 | + |
| 42 | +**Steps**: |
| 43 | + |
| 44 | +1. Navigate to your project directory. For example: |
| 45 | + ```bash |
| 46 | + cd /opt/proyectos/agarnung.github.io |
| 47 | + ``` |
| 48 | +2. Create an initial Gemfile with Bundler: |
| 49 | + ```bash |
| 50 | + bundle init |
| 51 | + ``` |
| 52 | +3. Open the Gemfile and add the following lines to include Jekyll and the jekyll-gist plugin: |
| 53 | + ```bash |
| 54 | + gem 'jekyll' |
| 55 | + gem 'jekyll-gist' |
| 56 | + ``` |
| 57 | +4. Create a _config.yml file in the root of your project with the following basic configuration: |
| 58 | + ```yml |
| 59 | + title: agarnung.github.io |
| 60 | + description: My personal portfolio |
| 61 | + baseurl: "" # Empty for local development |
| 62 | + url: "" # Empty for local development |
| 63 | +
|
| 64 | + plugins: |
| 65 | + - jekyll-gist |
| 66 | + ``` |
| 67 | +5. Open the _includes/elements/github_edit_footer.html file and leave it empty to avoid errors while testing locally. Later, when the repository is finished and public, you can add the following content: |
| 68 | + ```html |
| 69 | + <footer class="github-footer"> |
| 70 | + This page is <b>open source</b>. Noticed a typo? <br /> |
| 71 | + Or something unclear? {% github_edit_link "Improve it on GitHub" %}. |
| 72 | + </footer> |
| 73 | + ``` |
| 74 | +6. Install the dependencies with: |
| 75 | + ```bash |
| 76 | + bundle install |
| 77 | + ``` |
| 78 | +7. Verify that the Jekyll gem is installed correctly: |
| 79 | + ```bash |
| 80 | + bundle exec jekyll --version |
| 81 | + ``` |
| 82 | +8. Run your Jekyll site locally with: |
| 83 | + ```bash |
| 84 | + bundle exec jekyll serve |
| 85 | + ``` |
| 86 | +### Done! |
| 87 | +You can now access your website locally at http://127.0.0.1:4000. If you encounter any issues, check the _config.yml and Gemfile, or refer to the official Jekyll documentation. |
| 88 | + |
| 89 | + |
| 90 | + |
| 91 | + |
| 92 | + |
| 93 | + |
| 94 | + |
| 95 | + |
3 | 96 |
|
0 commit comments