Read in other languages: Russian, हिन्दी, 中國人
Important information that the user should read before continuing, project descriptions on GitHub in the language markdown markup is placed in the file "README.md"
The term dates back to at least the 1970s, the time when informational paper notes were placed on stacks. punched cards "READ ME!" scribbled on them describing their use. Possibly titled README could be a playful nudge to Lewis Carroll's Alice's Adventures in Wonderland, which has a potion and cake with labeled "DRINK ME" and "EAT ME" respectively.
The README pattern displayed in capital letters is a consistent aspect throughout history. In addition to the visual expressiveness of using capital letters, UNIX systems sort capital letters before in lowercase letters, conveniently placing README before the rest of the contents of the directory.
- Horizontal-line
- Title
- Text
- 3.1. plain text
- 3.2. One line of text
- 3.3. Multiline text
- 3.4. Text selection
- 3.5. Line wrapping
- 3.6. Italics
- 3.7. Fatty
- 3.8. Strikethrough
- Insert tables
- Lists
- 5.1. Marked
- 5.2. Numbered
- Links
- 6.1. Text hyperlink
- 6.2. Image link
- Useful links
- 7.1. Shields
- 7.2. Emoji
- Hidden menu
A horizontal line (separating line) can be obtained in three ways:
- *** (using three consecutive '*' (asterisk))、
- --- (using three consecutive '-' (dash))、
- ___ (using three consecutive '_' characters (underscore))
they all display the horizontal line effect
The heading (font) size can be 6 levels, it depends on the number of # (pound) characters at the beginning of the line.
# First level heading
## Heading of the second level
### Third level heading
#### Fourth level heading
##### Level 5 heading
###### Level 6 heading
A first level heading can also be created with one or more '=' characters placed on line following the title:
Heading 1
=
A second level heading can also be created with one or more '-' characters placed on line following the title:
Heading 2
-
Here the usual text is displayed, without any manipulations.
text on one line
Add 4 spaces at the beginning of the line and your text will be highlighted in a separate window, as in the example. Sometimes it works on tab, but not always.... the tab character is sometimes indented by 3 or more spaces.
HERE LIES A BIG STUDENT;
HIS FATE IS NEGOTIABLE.
CARRY AWAY MEDICINE:
THE ILLNESS OF LOVE IS INCURED!
Add 4 spaces at the beginning of each line and your text will be highlighted in a separate window, as in the example.
The above examples will not be able to keep the indentation of complex text on each line, for this purpose use in three backticks "```", and they must be on separate lines before and after the text, respectively.
"Strive not for success, but for the values that it gives."
Albert Einstein
If you only use a pair of backticks, then your text will be highlighted, but not indented. Same way you can highlight individual words in the text.
Life is what happens to you while you are making plans. John Lennon
Logic can take you from point A to point B, and imagination can take you anywhere. (Albert Einstein)
But that's not all, often we feel the need to place code fragments, it is desirable not only to keep indents, but also highlight with color, for this you need to specify the programming language after the first three quotes
from django.contrib import admin
# admin settings
# Register your models here.
from .models import Phonenumber, Division, MilitaryUnit
class PhonenumberAdmin(admin.ModelAdmin): # describe the Directory section of the admin panel
# specify the displayed fields
list_display = (
'id',
'military_unit', # specify the military unit from the MilitaryUnit table
'division', # specify the division from the Division table
'subdivision',
)Perhaps this is not usual and not familiar, but when you press the "Enter" button, your text will still be displayed in one line, and in order for your transfer to work, you need to add two spaces at the end of the line
Or just add an empty string, i.e. press "Enter" 2 times. In this case, the transfer effect will be achieved, but line spacing will be larger.
Place text between two characters '*' (asterisks) or '_' (underscores) and it will turn into italic text or italic text
*italic text* or _italic text_
Place text between two double '*' (asterisks) or '_' (underscore) characters and it will turn into bold text or bold text
__bold text__ or **bold text**
Text between three characters '*' (asterisks) or '_' (underscores) turns it into bold italic text: Bold Italic or Bold Italic
___Bold Italic___ or ***Bold Italic***
Place text between two double '~' characters and it will turn into
Strikethrough TEXT
~~Strikethrough TEXT~~
simple table
|Author|Andrey Marinchenko|
|---|---|
|Profession| python-developer|
|Article| About markup in the README|
| Author | Andrey Marinchenko |
|---|---|
| Profession | python-developer |
| Article | About markup in the README |
A bulleted list is formed by the characters -, + or * that begin each new line of the list
- first
- second
- the third
The numbered list is created like regular line numbering,
- first 1.1. first subparagraph 1.2. second subparagraph 1.3. third subparagraph
- second
- third
- fourth
We can just add a link from the browser https://github.com/BEPb and it will work, but if we want to hide it after the text, the link must be placed in parentheses, and the text in square brackets immediately before the link
Click here ---> [tyts](https://github.com/BEPb)
Click here ---> tyts
If we form a link inside the README.md file, then we should remember that we can only refer to headers, See "Heading" section
[See "Heading" section](#Heading)
But what if the title consists of several words?... You need to replace all spaces with '-' as a section about Horizontal line
[Horizontal line](#Horizontal-line)
Everything works exactly the same combination of exclamation point + square brackets + parentheses
If you have previously created a folder with images that you wish to use in your README file, then for displaying such images, you must specify the relative address of your file in the repository, for example, in my the media folder contains an image called super.jfif, to display you need to enter
https://shields.io/ - If you want to add shields, for example those at the beginning of this file, then go to the site, select a shield, usually type in the name on the gihab, the name of the repository and copy the code of the shield into your readme file.
https://github.com/BEPb/README/blob/master/emogi.md - If you want to decorate your readmi file with emoji :smiling_imp: , :innocent: then just copy the code from the table opposite the one you need.
Hidden menu
What do I need to do to get collapsible text?
Copy the given code and paste your blocks and symbols
</b></details>
<details>
<summary> The name of your hidden text </summary><br><b>
Here is your hidden text
</b></details>