зеркало из
1
0
Форкнуть 0
This commit is contained in:
David Strack 2019-08-22 18:02:46 -05:00 коммит произвёл GitHub
Коммит 715b0c8009
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
4 изменённых файлов: 175 добавлений и 0 удалений

140
README.md Normal file
Просмотреть файл

@ -0,0 +1,140 @@
# Welcome to GitHub
Welcome to GitHub—where millions of developers work together on software. Ready to get started? Lets learn how this all works by building and publishing your first GitHub Pages website!
## Repositories
Right now, were in your first GitHub **repository**. A repository is like a folder or storage space for your project. Your project's repository contains all its files such as code, documentation, images, and more. It also tracks every change that you—or your collaborators—make to each file, so you can always go back to previous versions of your project if you make any mistakes.
This repository contains three important files: The HTML code for your first website on GitHub, the CSS stylesheet that decorates your website with colors and fonts, and the **README** file. It also contains an image folder, with one image file.
## Describe your project
You are currently viewing your project's **README** file. **_README_** files are like cover pages or elevator pitches for your project. They are written in plain text or [Markdown language](https://guides.github.com/features/mastering-markdown/), and usually include a paragraph describing the project, directions on how to use it, who authored it, and more.
[Learn more about READMEs](https://help.github.com/en/articles/about-readmes)
## Your first website
**GitHub Pages** is a free and easy way to create a website using the code that lives in your GitHub repositories. You can use GitHub Pages to build a portfolio of your work, create a personal website, or share a fun project that you coded with the world. GitHub Pages is automatically enabled in this repository, but when you create new repositories in the future, the steps to launch a GitHub Pages website will be slightly different.
[Learn more about GitHub Pages](https://pages.github.com/)
## Rename this repository to publish your site
We've already set-up a GitHub Pages website for you, based on your personal username. This repository is called `hello-world`, but you'll rename it to: `username.github.io`, to match your website's URL address. If the first part of the repository doesnt exactly match your username, it wont work, so make sure to get it right.
Let's get started! To update this repositorys name, click the `Settings` tab on this page. This will take you to your repositorys settings page.
![repo-settings-image](https://user-images.githubusercontent.com/18093541/63130482-99e6ad80-bf88-11e9-99a1-d3cf1660b47e.png)
Under the **Repository Name** heading, type: `username.github.io`, where username is your username on GitHub. Then click **Rename**—and thats it. When youre done, click your repository name or browsers back button to return to this page.
<img width="1039" alt="rename_screenshot" src="https://user-images.githubusercontent.com/18093541/63129466-956cc580-bf85-11e9-92d8-b028dd483fa5.png">
Once you click **Rename**, your website will automatically be published at: https://your-username.github.io/. The HTML file—called `index.html`—is rendered as the home page and you'll be making changes to this file in the next step.
Congratulations! You just launched your first GitHub Pages website. It's now live to share with the entire world
## Making your first edit
When you make any change to any file in your project, youre making a **commit**. If you fix a typo, update a filename, or edit your code, you can add it to GitHub as a commit. Your commits represent your projects entire history—and theyre all saved in your projects repository.
With each commit, you have the opportunity to write a **commit message**, a short, meaningful comment describing the change youre making to a file. So you always know exactly what changed, no matter when you return to a commit.
## Practice: Customize your first GitHub website by writing HTML code
Want to edit the site you just published? Lets practice commits by introducing yourself in your `index.html` file. Dont worry about getting it right the first time—you can always build on your introduction later.
Lets start with this template:
```
<p>Hello World! Im [username]. This is my website!</p>
```
To add your introduction, copy our template and click the edit pencil icon at the top right hand corner of the `index.html` file.
<img width="997" alt="edit-this-file" src="https://user-images.githubusercontent.com/18093541/63131820-0794d880-bf8d-11e9-8b3d-c096355e9389.png">
Delete this placeholder line:
```
<p>Welcome to your first GitHub Pages website!</p>
```
Then, paste the template to line 15 and fill in the blanks.
<img width="1032" alt="edit-githuboctocat-index" src="https://user-images.githubusercontent.com/18093541/63132339-c3a2d300-bf8e-11e9-8222-59c2702f6c42.png">
When youre done, scroll down to the `Commit changes` section near the bottom of the edit page. Add a short message explaining your change, like "Add my introduction", then click `Commit changes`.
<img width="1030" alt="add-my-username" src="https://user-images.githubusercontent.com/18093541/63131801-efbd5480-bf8c-11e9-9806-89273f027d16.png">
Once you click `Commit changes`, your changes will automatically be published on your GitHub Pages website. Refresh the page to see your new changes live in action.
:tada: You just made your first commit! :tada:
## Work with GitHub on your computer using GitHub Desktop
**GitHub Desktop** is a free app from GitHub for Windows and Mac that allows you to easily work with your GitHub repositories from your computer. You just saw how you can commit to a repository from GitHub.com, but most developers do the majority of their work from their computer (locally) before pushing it up to GitHub. So lets try that out!
[Download GitHub Desktop](https://desktop.github.com/)
## Practice: Use GitHub Desktop and an editor to make a change from your computer
Start by downloading GitHub Desktop if you havent already done so, and install it on your computer. Go through the GitHub Desktop onboarding steps, and when you get to the “Lets get started” screen, go ahead and choose the repository you were just working with on GitHub.com, and click “Clone.”
### Using an editor to make changes
Lets make sure you have a text editor on your computer - this is what you'll use to actually make changes to your files. If you already know you have an editor, then skip to the next step. Otherwise, download and install either [Visual Studio Code](https://code.visualstudio.com/) or [Atom](https://atom.io/) and restart GitHub Desktop before proceeding to the next step.
Lets make a change to your GitHub Pages site, just like you did on GitHub.com, except this time were going to do it all from your computer. From GitHub Desktop, click the “Open in…” button in the middle of the screen to “open the repository in your external editor” that you just downloaded.
![Open-in-editor](https://user-images.githubusercontent.com/721500/63188833-82fb9600-c030-11e9-8777-a67c1713d59f.png)
In the left sidebar, click the `index.html` file to open it, and go ahead and add another line. Maybe, “Building websites is fun! You should try it too!” or whatever you want to add.
![Make-changes](https://user-images.githubusercontent.com/721500/63188832-82fb9600-c030-11e9-9f7b-7d15385a16f0.png)
Now switch back to GitHub Desktop, and you should see the change you made.
![View-changes](https://user-images.githubusercontent.com/721500/63188835-82fb9600-c030-11e9-8980-43a8231ca23a.png)
### Commit your changes
Now you can commit your changes by typing a message in the `Summary` box at the bottom left, and then click the blue `Commit` button below that.
![Commit-changes](https://user-images.githubusercontent.com/721500/63188831-8262ff80-c030-11e9-809a-f87d8b544935.png)
### Push your changes to GitHub.com
One of the great things about working on things on your computer is that you get to control when other people see them. Now lets push your commit to GitHub.com as well so its saved there and you can publish it to your site. Click the “Push origin” button to push your commit to GitHub.com.
![Push-to-GitHub](https://user-images.githubusercontent.com/721500/63188834-82fb9600-c030-11e9-9d8e-6c6ed6d48504.png)
Now click the “View on GitHub” button to get back to your repositorys page on GitHub.com.
![View-on-GitHub](https://user-images.githubusercontent.com/721500/63188836-82fb9600-c030-11e9-9bc5-cf304398500d.png)
### Deploy and see your changes live on your GitHub Pages website!
Once you commit your changes, they are automatically published on your GitHub Pages website. Refresh your browser to see it live!
### Celebrate!
Hooray! Now you have your repository linked between your computer and GitHub.com. In the future, you can use GitHub Desktop to push any changes you decide to make from your computer.
## Extra Credit: Keep on building!
Change the placeholder Octocat gif on your GitHub Pages website by [creating your own personal Octocat emoji](https://myoctocat.com/build-your-octocat/) or [choose a different Octocat gif from our logo library here](https://octodex.github.com/). Add that image to line 12 of your `index.html` file, in place of the `<img src=` link.
Want to add even more code and fun styles to your GitHub Pages website? [Follow these instructions](https://github.com/github/personal-website) to build a fully-fledged static website.
![octocat](./images/create-octocat.png)
## Everything you need to know about GitHub
Getting started is the hardest part. If theres anything youd like to know as you get started with GitHub, try searching [GitHub Help](https://help.github.com). Our documentation has tutorials on everything from changing your repository settings to configuring GitHub from your command line.

Двоичные данные
images/create-octocat.png Normal file

Двоичный файл не отображается.

После

Ширина:  |  Высота:  |  Размер: 264 KiB

18
index.html Normal file
Просмотреть файл

@ -0,0 +1,18 @@
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
<title>my-first-website</title>
<LINK href="styles.css" rel="stylesheet" type="text/css">
</head>
<body>
<img src="https://octodex.github.com/images/daftpunktocat-thomas.gif" id="octocat" alt="octocat-gif" />
<!-- Change this code here by copy and pasting your template on line 15 -->
<p>Welcome to your first GitHub Pages website!</p>
</body>
</html>

17
styles.css Normal file
Просмотреть файл

@ -0,0 +1,17 @@
* {
margin:0px;
padding:0px;
}
#octocat {
display: block;
width:384px;
margin: 50px auto;
}
p {
display: block;
width: 400px;
margin: 50px auto;
font: 30px Monaco,"Courier New","DejaVu Sans Mono","Bitstream Vera Sans Mono",monospace;
}