Quick Start
If you want to directly jump into using ProfileIO without getting into the details, this section is for you. For further details and comprehensive information about the schema employed, please go through subsequent sections.
Prerequisites
File structure
profileio
├── _profile/
│ └── profile_web.yml
│ └── profile_resume.yml
│ └── images/ <-- Place images here
│ └── files/ <-- Place files here
│ └── *.md
├── ...
├── ...
Data from profile_web.yml
will be used to generate website and profile_resume.yml
will be used to generate pdf résumé.
Demo
- Source: profile_web.yml
- Result: 👉 Generated website
- Source: profile_resume.yml
- Result: 👉 Generated Résumé
How to start?
- Fork the repository 👉 ProfileIO
- (GitHub pages): If you want to deploy website to github pages, rename the repository to
<github username>.github.io
- (One time task): To allow profileio workflows do their job, please enable workflows via
Actions
. After enabling, if you want them to run before make any changes tomain
repo of your branch, clickRun workflow
forBuild and deploy
Actions -> Build and deploy -> Run workflow -> Branch: main
- Update contents of
_profile/
either using github IDE or by cloning your repository and pushing the changes - Wait until github actions complete
- (GitHub pages): Add
gh-pages
orgh-pages-mac
as source for GitHub pagesYour repository -> settings -> GitHub pages -> Source
- If you want to deploy to netlify, use
deployment_platforms
as the production branch in netlify UI andbuild
for the directory to publish - If you want to host website on your own server, you may use the directory
build/
after building the project
How it works?
- Once pushed to github, actions will build both web and pdf résumé
- Generated résumé will be linked to the website and displayed if
showResumeLink
is set inprofile_web.yml
- Build files are pushed to
gh-pages
,gh-pages-mac
branches - Source repo, combined with résumé copied to
_public/files/resume
will be pushed todeployment_platforms
Which branch to use?
gh-pages
- Contents of this branch will be built using Linux virtual environment. In most cases you may use this branch, and this is in general available quickly
- If you need Helvetica Neue font for the resume, you may use
gh-pages-mac
gh-pages-mac
- Mac virtual environment will be used to build your resume. With the current github workflow configuration, there is about 5 minutes delay when compared to
gh-pages
for the contents to be available under this branch
- Mac virtual environment will be used to build your resume. With the current github workflow configuration, there is about 5 minutes delay when compared to
deployment_platforms
- Use this branch if you want to deploy your website using netlify
- You may also use this if you want github actions to compile your resume
- This is almost same as the
main
branch with the exception of the compiled resume, which will be copied to _profile/files/resume - In the current configuration this branch will be updated three times per workflow in the following sequence
- Contents of branch
main
will be made available for this branch - Resume from Linux build will be pushed to this branch as soon as available
- Resume from Mac build will be pushed as soon as that step completes
- Contents of branch
If you find any bugs or need a feature, please raise an issue, or submit a PR.