Creating your site
Docusaurus was created to hopefully make it super simple for you to create a site and documentation for your open source project.
Kurulum ve hazırlıktan sonra dokümanlarınız için basit bir site oluşturma işinin çoğu tamamlanmış olur.
Site Yapısı
Your site structure looks like the following:
root-of-repo
├── docs
└── website
│ └── blog
│ └── core
│ └── Footer.js
│ └── node_modules
│ └── package.json
│ └── pages
│ └── sidebars.json
│ └── siteConfig.js
│ └── static
This assumes that you removed the example
.md
files that were installed with the initialization script.
All of your documentation files should be placed inside the docs
folder as markdown .md
files. Any blog posts should be inside the blog
folder.
The blog posts must be formatted as
YYYY-MM-DD-your-file-name.md
Temel Sitenizi Oluşturun
Tamamen fonksiyonel bir site oluşturmak için, sadece birkaç adımı yapmanız gerekir:
Add your documentation to the
/docs
folder as.md
files, ensuring you have the proper header in each file. The simplest header would be the following, whereid
is the link name (e.g.,docs/intro.html
) and thetitle
, is, of course, the title of the browser page.--- id: intro title: Getting Started --- My *new content* here..
Add zero or more docs to the
sidebars.json
file so that your documentation is rendered in a sidebar, if you choose them to be.Eğer dosyalarınızı
sidebars.json
dosyasına eklemezseniz, dokümanlar işlenecektir ancak sadece diğer dokümanlara bağlantılanabilirler ve sadece URL biliniyorsa ziyaret edilebilirler.Modify the
website/siteConfig.js
file to configure your site, following the comments included in the docs and thewebsite/siteConfig.js
to guide you.Create any custom pages and/or customize the
website/core/Footer.js
file that provides the footer for your site.Resimler gibi varlıkları
website/static/
klasörüne yerleştirin.Değişikliklerinizin sonuçlarını görmek için siteyi çalıştır.
cd website yarn run start # or `npm run start` # navigate to http://localhost:3000