Giter VIP home page Giter VIP logo

davidlhw.dev's Introduction

Getting Started

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.

Build

Generate a full static production build

npm run build

Preview the site as it will appear once deployed

npm run start

Customizing and Configurations

For specific configurations, refer to the Configuration Guide.

Generating Resume QR Code

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.

Creating an Article

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

Defining Markdown File

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.

Adding an Article

  1. Define and store your markdown files in config/articles/markdown/blogs for blog-related articles or config/articles/markdown/projects for project-related articles.
  2. To add an article to blog page: add a new entry in config/articles/blogs.ts, under article array.
  3. Similarly for project article: add a new entry instead in config/articles/projects.ts

Adding a Skillset

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.

  1. Source for an svg logo for that skill (or technology). Refer to the SVG Tools section for resources on getting the svg logos.
  2. Add the SVG as a component under components/svg/programming.
  3. Update components/svg/utils.tsx and Lang type under config/landing/types.ts.
  4. Add to config/landing/skillsets.ts and/or tags fields under config/articles/*

Additional Information

SVG Tools

Social Sharing API Reference

davidlhw.dev's People

Contributors

davidlhw avatar

Stargazers

Jia Wei Lee avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.