Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New blog feature #9

Merged
merged 1 commit into from
Feb 25, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions my-blog-website/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Dependencies
/node_modules

# Production
/build

# Generated files
.docusaurus
.cache-loader

# Misc
.DS_Store
.env.local
.env.development.local
.env.test.local
.env.production.local

npm-debug.log*
yarn-debug.log*
yarn-error.log*
41 changes: 41 additions & 0 deletions my-blog-website/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Website

This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.

### Installation

```
$ yarn
```

### Local Development

```
$ yarn start
```

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

### Build

```
$ yarn build
```

This command generates static content into the `build` directory and can be served using any static contents hosting service.

### Deployment

Using SSH:

```
$ USE_SSH=true yarn deploy
```

Not using SSH:

```
$ GIT_USER=<Your GitHub username> yarn deploy
```

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
3 changes: 3 additions & 0 deletions my-blog-website/babel.config.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
module.exports = {
presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
};
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
56 changes: 56 additions & 0 deletions my-blog-website/blog/2024-02-25-open-source-for-beginners/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,56 @@
---
slug: first-blog-post
title: Starting with Open Source
authors:
name: Sudhanshu Dasgupta
title: SWE | Open Source Maintainer
url: https://github.com/sudhanshutech
image_url: https://avatars.githubusercontent.com/u/90546692?v=4
tags: [open-source, beginners, github]
---


## Getting started with Open Source journey for beginners.

### Why do we require it?

As a student, gaining real-world experience is crucial to preparing for a career in your field. One of the best ways to achieve this experience is by participating in open-source projects. Open source projects provide an opportunity to work on real-world projects and collaborate with a diverse group of individuals, including industry professionals.

By contributing to open-source projects, you can demonstrate your skills and gain exposure to new technologies and practices. You'll also have the opportunity to interact with mentors and experienced professionals who can provide guidance and feedback on your work. This can help you build your professional network and gain a deeper understanding of the industry.


### What is Open Source?

Open source refers to a type of software license that allows the source code of a program to be made available to the public, allowing anyone to use, modify, or distribute the code for any purpose.

The open-source model is based on the idea of collaboration and sharing, allowing developers from around the world to work together to create and improve the software.

### Myths about Open Source

![Docusaurus Plushie](./images.jpg)

- **I need to be an expert to contribute**: This is not true. Open source projects welcome contributions from individuals of all skill levels and often have a need for tasks that don't require extensive technical knowledge.

- **I don't have any unique skills to contribute**: Everyone has something unique to offer, regardless of their technical expertise. Open-source projects value a diverse range of perspectives and skill sets, including documentation, design, testing, and project management.

- **My contributions won't be accepted**: While it is true that not every contribution will be accepted, the open-source community is generally welcoming and supportive of new contributors. If your contribution is not accepted, you can use the feedback to improve your skills and make better contributions in the future.

- **It will be too time-consuming**: While contributing to open source can be time-consuming, it is also a great way to build your skills and gain experience. You can start with small contributions and work your way up as you become more familiar with the project and the community.

- **The community is unfriendly and unapproachable**: This is a common misconception, as many open-source communities are highly collaborative and welcoming to new contributors. If you do encounter any negative behavior, there are resources and tools in place to address these issues.

### How do I get involved with Open Source?

&star; Join a community or organization or find any open source repositories at Github.

Some resources will be provided at the end of this article.

&star; Try to have discussions with those communities for asking help, support, or resources.

&star; Learn about GitHub.

&star; Start with improving documentation(readme) or find a good first issue label in those repositories and try to fix them.

&star; Look for open-source tools, libraries, or frameworks you are already familiar with.

&star; Participate in open source programs to get involved more such as MLH Fellowship or you can go through this [website](https://blog.wemakedevs.org/25-paid-open-source-programs-and-internships).
134 changes: 134 additions & 0 deletions my-blog-website/docusaurus.config.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,134 @@
// @ts-check
// `@type` JSDoc annotations allow editor autocompletion and type checking
// (when paired with `@ts-check`).
// There are various equivalent ways to declare your Docusaurus config.
// See: https://docusaurus.io/docs/api/docusaurus-config

import {themes as prismThemes} from 'prism-react-renderer';

/** @type {import('@docusaurus/types').Config} */
const config = {
title: 'Doc N Blog',
tagline: 'Bring your ideas and work as open source',
favicon: 'img/favicon.ico',


// Set the production url of your site here
url: 'https://your-docusaurus-site.example.com',
// Set the /<baseUrl>/ pathname under which your site is served
// For GitHub pages deployment, it is often '/<projectName>/'
baseUrl: '/',

// GitHub pages deployment config.
// If you aren't using GitHub pages, you don't need these.
organizationName: 'facebook', // Usually your GitHub org/user name.
projectName: 'docusaurus', // Usually your repo name.

onBrokenLinks: 'throw',
onBrokenMarkdownLinks: 'warn',


// Even if you don't use internationalization, you can use this field to set
// useful metadata like html lang. For example, if your site is Chinese, you
// may want to replace "en" with "zh-Hans".
i18n: {
defaultLocale: 'en',
locales: ['en'],
},


presets: [
[
'classic',
/** @type {import('@docusaurus/preset-classic').Options} */
({
docs: false,
blog: {
showReadingTime: true,
routeBasePath: '/',
// Please change this to your repo.
// Remove this to remove the "edit this page" links.
editUrl:
'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
},
theme: {
customCss: './src/css/custom.css',
},
}),
],
],

themeConfig:
/** @type {import('@docusaurus/preset-classic').ThemeConfig} */
({
// Replace with your project's social card
image: 'img/docusaurus-social-card.jpg',
navbar: {
title: 'Doc N Blog',
logo: {
alt: 'My Site Logo',
src: 'img/logo.svg',
},
items: [

{to: '/blog', label: 'Blog', position: 'left'},
{
href: 'https://github.com/facebook/docusaurus',
label: 'GitHub',
position: 'right',
},
],
},
footer: {
style: 'dark',
links: [
// {
// title: 'Docs',
// items: [
// {
// label: 'Tutorial',
// to: '/docs/intro',
// },
// ],
// },
{
title: 'Community',
items: [
{
label: 'Stack Overflow',
href: 'https://stackoverflow.com/questions/tagged/docusaurus',
},
{
label: 'Discord',
href: 'https://discordapp.com/invite/docusaurus',
},
{
label: 'Twitter',
href: 'https://twitter.com/docusaurus',
},
],
},
{
title: 'More',
items: [
{
label: 'Blog',
to: '/blog',
},
{
label: 'GitHub',
href: 'https://github.com/facebook/docusaurus',
},
],
},
],
copyright: `Copyright © ${new Date().getFullYear()} Doc N Blog, Inc. Built by Sudhanshu - Open source dev.`,
},
prism: {
theme: prismThemes.github,
darkTheme: prismThemes.dracula,
},
}),
};

export default config;
Loading
Loading