These instructions will get you a copy of the project up and running on your local machine for interaction, development and testing purposes.
Install dependencies
npm install
# or
yarn
Run the development server:
npm run dev
# or
yarn dev
Open http://localhost:3000 with your browser to see the result.
Generate a full static production build
npm run build
Preview the site as it will appear once deployed
npm run start
For specific configurations, refer to the Configuration Guide.
Generate your QR Code with the URL as https://[your domain]?resume=true
. The app will check for the existence of this query parameter: resume=true
on page load and will open the resume modal immediately if parameter exists.
Article entries are defined in /config/articles/markdown
. If in doubt, follow the sample defined. More info about the property are listed below:
Property | Description |
---|---|
uid |
The unique ID of each article, make sure the uid are unique throughout all the array objects |
coverImageUrl |
Cover image used in landing page and read more section |
title |
Article's Title |
publishOn |
Follow the date format: DD/MM/YYYY |
readTime |
Estimated read time of the article |
tags |
The tags associated with the article. Tags has to be a skillset object, see landing section, under skillsets |
linkUrl |
All links are optional, if no link: then no buttons will be shown. Supports facebook , twitter , github & realSite . realSite is mainly used for project-article to redirect to live-demo site |
mdxFilename |
Markdown file name defining the content of the article, more on that in the next subsection |
summary |
Summary of the whole article |
MDX are used to parse markdown file into JSX. This allows for more customization of markdown components and styling.
Markdown created this way will be defined as *.mdx
.
Consider adding editor support for .mdx
for more seamless experience in creating .mdx
files.
The standard heading is h3
, also known as ###
in markdown script. Please make sure to add anchor a
HTML tag beside the heading, with id
specified. The app will look for this anchor tag and recognize it as heading
Have a look into Prototyping.mdx
, you can import other JSX files as a component inside the markdown. This external components are defined as plugin
in the project. Currently there are 2: (i) Image.tsx
and (2) Quote.tsx
.
- Define and store your markdown files in
config/articles/markdown/blogs
for blog-related articles orconfig/articles/markdown/projects
for project-related articles. - To add an article to blog page: add a new entry in
config/articles/blogs.ts
, underarticle
array. - Similarly for project article: add a new entry instead in
config/articles/projects.ts
Once you've pickup a new skill, you would want to add it on in your skillsets
as a tag to be referenced throughout the site.
- Source for an svg logo for that skill (or technology). Refer to the SVG Tools section for resources on getting the svg logos.
- Add the SVG as a component under
components/svg/programming
. - Update
components/svg/utils.tsx
andLang
type underconfig/landing/types.ts
. - Add to
config/landing/skillsets.ts
and/ortags
fields underconfig/articles/*