React.jsを使用してポートフォリオWebサイトを作成する方法

友達が週末の計画をキャンセルした後、私は時間をつぶすために何かを探していました。長い間保留されていた「Wish-To-Do」のリストを確認した後、最終的にポートフォリオWebサイトを作成する計画になりました。物事。

その後、テクノロジーとテンプレートを何時間も検索した結果、React.jsを使用してこのウェブサイトを作成し、Githubページを使用してデプロイすることになりました。このWebサイトのコードはここにあります(技術的には「Webアプリ」と呼ばれますが、この記事では「Webサイト」と呼びます…大丈夫だと思います)。

あなたが学ぶこと

  • React.jsのいくつかの基本的な概念
  • HTMLWebサイトからcreate-react-appを使用する方法
  • 「Githubpages」を使用してポートフォリオWebサイトをデプロイする方法

始める前に知っておく必要のあるいくつかの概念..

注— React.jsとReactコンポーネントの基本的な概念に既に精通している場合は、この部分をスキップしてかまいません。

これらのポイントは、Reactの世界の非常に基本的な考え方を提供します。ドキュメントからReactについてもっと学び、freeCodeCampの助けを借りて実践することを強くお勧めします。

React.jsとは>

今のところ、React.jsがUIコンポーネントの構築に使用されるJavaScriptライブラリであることを知っていれば十分です。これはFacebookのエンジニアによって作成され、現在ではJavaScriptの世界を揺るがしています。

Reactコンポーネントとは>

Reactを使用すると、コンポーネントをクラスまたは関数として定義できます。' props 'と呼ばれるコンポーネントにオプションの入力を提供できます。

コンポーネントを使用すると、UIをヘッダー、フッター、本文などの独立したセクションに分割できます。各コンポーネントは独立して機能するため、ページ全体に影響を与えることなく、個々のコンポーネントをReactDOMに個別にレンダリングできます。

また、マウント、レンダリング、更新、アンマウントなどのコンポーネントの状態に応じて実行するコードを定義できる「ライフサイクルメソッド」も付属しています

Reactコンポーネントには、独自のトレードオフがあります。たとえば、コンポーネントを他のコンポーネントにエクスポートすることで再利用できますが、複数のコンポーネントが相互に話し合ったり、レンダリングをトリガーしたりするのを処理するのが混乱する場合があります。

これは、コンポーネントがどのように見えるかです!

import React, { Component } from 'react' export default class Component-name extends Component { render() { return ( {these code will be rendered into the DOM} ) } }

GitHubPagesとは>

GitHub Pagesを使用すると、インフラストラクチャをセットアップすることなく、GitHubを使用してサイトを無料で簡単にデプロイできます。彼らはあなたが多くのことを心配する必要がないようにモジュールを提供しました。最後までこだわると、MAGICのように機能することがわかります!

先に進む前に、必ず..

あなたがあなたのウェブサイトに載せたいコンテンツを決定します

最新の履歴書を1回確認します(履歴書がない場合は、今すぐ作成して、このプロジェクトを次の週末まで延期しますか?)。それはあなたがあなたのポートフォリオのウェブサイトにどんな種類の情報を置きたいかについて明確な考えを持つのを助けるでしょう。

インスピレーションを見つける

ウェブ上の何百もの無料ポートフォリオウェブサイトテンプレートを閲覧し、それらからどのように何を使用できるかを確認します。ペンと紙を取り出し、大まかな図をスケッチして、ウェブサイトがどのようになるかを理解します。このテンプレートを使用してデモンストレーションします。

あなた自身の素晴らしい写真をいくつか集めてください

もちろん、あなたはあなた自身のポートフォリオのウェブサイトで見栄えを悪くしたくありません。だからあなたの写真のアーカイブを掘り下げてあなたのウェブサイトにぴったりの写真を見つけてください。

お気に入りのプレイリストに合わせてください

伝説によれば、良いものは良い音楽によってのみもたらされる…そしてあなたは確かに素晴らしいものを見逃したくない。

建物の部分に飛び込みましょう

In the following sections, I will describe steps to building the portfolio app but you don’t have to follow the same code I use. Focus on learning the concepts and show some creativity! Further reading has been divided into three sections.

  1. Setting up the React-app
  2. Breaking down the HTML page into React components
  3. Deploying your app onto Github pages

Setting up React-app

We will be using create-react-app — a module provided by Facebook — which helps us to create React.js apps with ease and without worrying about build tools.

  • Go to the console and run npm install create-react-app to install this module via npm (make sure that you have installed npmbefore using it — follow this link for more info).
  • Now run npm create-react-app ${project-name} which will fetch build scripts and create a file-structure which will look like this.
my-portfolio-app ├── README.md (description of the project for GitHUb) ├── node_modules (stores all dependent modules for the project) ├── package.json (stores all meta information of the prokect like dependencies,version,revisions etc.) ├── .gitignore (files declared here will be ignored while uploading to GitHub like node_modules ├── public (here you will store all images,JS,CSS files) │ ├── favicon.ico │ ├── index.html │ └── manifest.json └── src (our main code for app lies here) ├── {create component folder here} ├── App.css ├── App.js ├── App.test.js ├── index.css ├── index.js ├── logo.svg └── serviceWorker.js

Create a components folder under the src directory. This is where we will store our components in the future.

  • Copy all the images, fonts, HTML and CSS files from the HTML template you decided to work with into the public folder.

Now your project directory should look like this.

  • Run the npm install command which will install dependent modules under node_module directory.
  • If you’ve got it right up until now, then running the npm start command will start the React app on the localhost. Go to //localhost:3000and you should be able to see the starter page of the React-app.

Breaking-down the HTML page into React components..

Remember the component folder which we created under src directory in the previous step, now we will break down the HTML template page into components and combine these components to make our React-app.

  • First, you need to identify which components you can create from the monolithic HTML file — like header, footer and contact me. You need to be a little creative here!!
  • Look for tags like section/div which aren’t nested into some other section/div. These should contain code about that particular section of the page which is independent of other sections. Try looking into my GitHub Repo to get a better idea about this one.

    Hint: Use the ‘inspect element’ tool to play around with the code and take notice of the effect of changes within the browser.

  • These pieces of HTML code will be used in the render() method of the component. The render() method will return this code whenever a component gets rendered into the ReactDOM. Take a look at the code blocks given below for reference.
  • Hi!

    I'm Jackson

    100% html5 bootstrap templates Made by colorlib.com

    Download CV

  • I am

    a Designer

    100% html5 bootstrap templates Made by colorlib.com

    View Portfolio

import React, { Component } from 'react' export default class Home extends Component { render() { return ( 
  • Hi!

    I'm Jackson

    100% html5 bootstrap templates Made by colorlib.com

    Download CV

  • I am

    a Designer

    100% html5 bootstrap templates Made by colorlib.com

    View Portfolio

) } }

Hint: If things are getting confusing on the react side — try focusing on the concept of ‘how to identify wanna be components from the HTML codebase’. After getting comfortable with React, implementation will be a piece of cake.

Did you notice that there are some changes in the HTML code? class became className. These changes are required because React doesn’t support HTML ? — they have come up with their own HTML-like JS syntax which is called JSX . So, we need to change some parts of the HTML code to make it JSX.

I bumped into this HTML to JSX converter during this project, which converts HTML code into JSX for you ?. I highly recommend using this rather than changing your code manually.

After some time, you should come up with some different components. Now the EndGame is near!! Combine these different components under one App.js component (YES!! You can render one component from another component!) and your portfolio app will be ready.

import React, { Component } from 'react'; import './App.css'; import Sidebar from './components/sidebar' import Introduction from './components/introduction' import About from './components/about' import Projects from './components/projects' import Blog from './components/blog' import Timeline from './components/timeline' class App extends Component { render() { return ( ); } } export default App;

Notice in the above code that we need to first import the components in order to use them in the render() section. And we can use the components just by adding or just tag in the render method.

  • Run npm start from your terminal and you should be able to see the changes reflected in the website. You don’t need to run this command again if you have made more changes in the code, it will be reflected automatically when you save those changes. You can do some lightning fast development thanks to the hot reload feature.
  • Play around with the HTML and CSS to change the content according to your resume and make your portfolio even cooler by changing the content, trying out different fonts, changing the colours and adding photos of your choice.

Deploy React-app to Github pages

Okay, so you survived until this point… take a moment to appreciate your hard work. But you still need to complete your deployment so that you can share your cool work with your friends who ditched those weekend plans.

  • First, you need to install the npm library of Github pages. To install, run this command npm install gh-pages on your terminal.

Now, you need to make the following changes in your manifest.json file:

  • Add the homepage field — value will be in the following format — //{github_id}.github.io/{github_repo}
  • Add predeploy and deploy fields under scripts

Now your manifest.json should look like this:

{ "name": "portfolio-app", "version": "0.1.0", "private": true, "homepage": "//Dhruv34788.github.io/me", "dependencies": { "gh-pages": "^2.0.1", "react": "^16.8.3", "react-dom": "^16.8.3", "react-scripts": "2.1.5", "yarn": "^1.13.0"}, "scripts": { "start": "react-scripts start", "build": "react-scripts build", "predeploy": "yarn run build", "deploy": "gh-pages -d build", "test": "react-scripts test", "eject": "react-scripts eject"}, "eslintConfig": { "extends": "react-app"}, "browserslist": [ ">0.2%", "not dead", "not ie <= 11", "not op_mini all" ] }

Now go to the terminal, run npm run deploy and wait for the magic!! Your app will be deployed after the deployment scripts execute successfully. Verify whether your app has deployed or not by visiting the link you provided in the homepage field.

Caution: Please be careful when deploying anything onto the web. Perform safety checks like removing internal links, passwords, or anything that you don’t want to be there in the hands of smart people out there.

If you are going to make changes often...

Original text


Note —  You need to perform the deployment stage every time you change something and if you are making changes in the codebase - guess what whose going to get bored soon !!  ( No worries I got your back :P)

You can automate the deployment process using Travis-CI (automation tool), so that if you commit anything into master branch – the deployment steps will be triggered and new site will be automatically available. Follow this article for that.

//www.freecodecamp.org/news/learn-how-to-automate-deployment-on-github-pages-with-travis-ci/

Homework for you ..

Congratulations! You have finally created and deployed your portfolio app. If you are interested, then you can add these features to your website

  • Blog feature: create your own blog using Node.js and a NoSQL database like MongoDB and merge it into this portfolio website.
  • Gallery: add a section to the page where you can show the screenplay of the recent photos from your social media websites.
  • Twitter Feed: add a section showing recent tweets by you.
  • Random Quote: add a section showing some random motivational quotes.

If you implement any of these features, share your work with me. I would be more than happy to help ? ( if I can ?)

Wrapping up ..

I would like to take a moment to acknowledge the work of the people who gave me the inspiration and knowledge to complete this article.

  • Quincy Larson, Sahat Yalkabov & community: For creating freeCodeCamp — the platform where you can learn and gain knowledge about almost everything related to web technologies; using hands-on tutorials and all without paying fees. ?
  • Colorlib: for providing state of the art templates which were a huge inspiration for my portfolio website. ?
  • Daniel Lo Nigro & community: for creating HTML to JSX Compiler, which turned out to be handy while converting HTML blocks into JSX code. ?
  • My dearest friends: who helped me in correcting my mistakes.
  • YOU: for sticking around, I hope you had a productive time. Keep exploring and building amazing things!