Skip to content

Commit 8068e0e

Browse files
committed
Intended to use Jeckyll por my portfolio
1 parent 3c8e5a2 commit 8068e0e

File tree

3 files changed

+94
-5
lines changed

3 files changed

+94
-5
lines changed

README.md

Lines changed: 94 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,96 @@
11
# 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+
396

google971a30ea77aedd71.html

Lines changed: 0 additions & 1 deletion
This file was deleted.

index.html

Lines changed: 0 additions & 3 deletions
This file was deleted.

0 commit comments

Comments
 (0)