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

feat: add arabic translation #214

Closed
wants to merge 3 commits into from
Closed
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
2 changes: 1 addition & 1 deletion docs/_sidebar.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
[![OpenSauced Logo](../_assets/images/logo-on-dark.png)](https://opensauced.pizza/)
[![OpenSauced Logo](_assets/images/logo-on-dark.png)](https://opensauced.pizza/)

- [Open Source Education Path](/)

Expand Down
1 change: 1 addition & 0 deletions docs/community-translations.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@ We are grateful for the contributions of the community in translating our course
<!--
- [Language](link to your forked repository) - maintain by [GitHub username](link to your GitHub profile)
-->
- [Arabic](https://github.com/dvmhmdsd/open-sauced-translation) - maintain by [dvmhmdsd - Mohamed Saad](https://github.com/dvmhmdsd)

## Becoming a Maintainer Course

Expand Down
199 changes: 112 additions & 87 deletions docs/index.html
Original file line number Diff line number Diff line change
@@ -1,90 +1,115 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title>OpenSauced</title>
<link rel="icon" href="./_assets/images/slice-Gradient-White.png" />
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<meta name="description" content="Description" />
<meta
name="viewport"
content="width=device-width, initial-scale=1.0, minimum-scale=1.0"
/>
<link
rel="stylesheet"
href="//cdn.jsdelivr.net/npm/docsify-darklight-theme@latest/dist/style.min.css"
title="docsify-darklight-theme"
type="text/css"
/>
<link rel="stylesheet" href="./styles/custom.css" />
</head>
<body>
<div id="app"></div>
<script>
window.$docsify = {
name: "",
repo: "open-sauced/intro",
themeColor: "#25c2a0",
loadSidebar: "_sidebar.md",
loadNavbar: "_navbar.md",
mergeNavbar: true,
alias: {
// courses sidebar
"/.*/intro-to-oss/_sidebar.md": "/intro-to-oss/_sidebar.md",
"/.*/becoming-a-maintainer/_sidebar.md":
"/becoming-a-maintainer/_sidebar.md",
// courses navbar
"/.*/intro-to-oss/_navbar.md": "/intro-to-oss/_navbar.md",
"/.*/becoming-a-maintainer/_navbar.md":
"/becoming-a-maintainer/_navbar.md",
},
relativePath: true,
subMaxLevel: 3,
search: "auto",
search: {
maxAge: 86400000,
paths: "auto",
placeholder: "Search",
noData: "No Results found!",
depth: 6,
hideOtherSidebarContent: false,
},
darklightTheme: {
siteFont: "Inter",
bodyFontSize: "17px",
dark: {
background: "#2F3239",
textColor: "#FFFDFA",
accent: "#25c2a0",
highlightColor: "#25c2a0",
codeBackgroundColor: "#050505",
borderColor: "#25c2a0",
sidebarSublink: "#ffffff",
blockQuoteColor: "#FFE4AD",
coverBackground: "#11181C",
},
light: {
background: "#FFFFFF",
accent: "#205d3b",
highlightColor: "#205d3b",
borderColor: "#205d3b",
sidebarSublink: "#141414",
codeBackgroundColor: "#F2F2F2",
blockQuoteColor: "#3B555E",
coverBackground: "#FFFFFF",
},
},
auto2top: true,
}
</script>
<!-- Docsify v4 -->
<script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
<script src="//unpkg.com/docsify/lib/plugins/search.min.js"></script>
<script
src="//cdn.jsdelivr.net/npm/docsify-darklight-theme@latest/dist/index.min.js"
type="text/javascript"
></script>
<script src="//cdn.jsdelivr.net/npm/docsify-pagination/dist/docsify-pagination.min.js"></script>

</body>
<head>
<meta charset="UTF-8" />
<title>OpenSauced</title>
<link rel="icon" href="./_assets/images/slice-Gradient-White.png" />
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<meta name="description" content="Description" />
<meta
name="viewport"
content="width=device-width, initial-scale=1.0, minimum-scale=1.0"
/>
<link
rel="stylesheet"
href="//cdn.jsdelivr.net/npm/docsify-darklight-theme@latest/dist/style.min.css"
title="docsify-darklight-theme"
type="text/css"
/>
<link rel="stylesheet" href="./styles/custom.css" />
</head>
<body>
<div id="app"></div>
<script>
window.$docsify = {
name: "",
repo: "open-sauced/intro",
themeColor: "#25c2a0",
loadSidebar: "_sidebar.md",
loadNavbar: "_navbar.md",
mergeNavbar: true,
alias: {
// courses sidebar
"/.*/intro-to-oss/_sidebar.md": "/intro-to-oss/_sidebar.md",
"/.*/becoming-a-maintainer/_sidebar.md":
"/becoming-a-maintainer/_sidebar.md",
// courses navbar
"/.*/intro-to-oss/_navbar.md": "/intro-to-oss/_navbar.md",
"/.*/becoming-a-maintainer/_navbar.md":
"/becoming-a-maintainer/_navbar.md",
},
relativePath: true,
subMaxLevel: 3,
search: "auto",
search: {
maxAge: 86400000,
paths: "auto",
placeholder: window.location.hash.includes("ar") ? "البحث" : "Search",
noData: "No Results found!",
depth: 6,
hideOtherSidebarContent: false,
},
darklightTheme: {
siteFont: "Inter",
bodyFontSize: "17px",
dark: {
background: "#2F3239",
textColor: "#FFFDFA",
accent: "#25c2a0",
highlightColor: "#25c2a0",
codeBackgroundColor: "#050505",
borderColor: "#25c2a0",
sidebarSublink: "#ffffff",
blockQuoteColor: "#FFE4AD",
coverBackground: "#11181C",
},
light: {
background: "#FFFFFF",
accent: "#205d3b",
highlightColor: "#205d3b",
borderColor: "#205d3b",
sidebarSublink: "#141414",
codeBackgroundColor: "#F2F2F2",
blockQuoteColor: "#3B555E",
coverBackground: "#FFFFFF",
},
},
auto2top: true,
};
</script>
<!-- Docsify v4 -->
<script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
<script src="//unpkg.com/docsify/lib/plugins/search.min.js"></script>
<script
src="//cdn.jsdelivr.net/npm/docsify-darklight-theme@latest/dist/index.min.js"
type="text/javascript"
></script>
<script src="//cdn.jsdelivr.net/npm/docsify-pagination/dist/docsify-pagination.min.js"></script>
<script>
document.addEventListener("DOMContentLoaded", function () {
if (window.location.hash.includes("ar")) {
document.querySelector("html").setAttribute("dir", "rtl");
document.querySelector("html").setAttribute("lang", "ar");
document.querySelector("body").classList.add("rtl-lang");
} else {
document.querySelector("html").setAttribute("dir", "ltr");
document.querySelector("html").setAttribute("lang", "en");
document.querySelector("body").classList.remove("rtl-lang");
}
});

// Change the layout of the page on changing the language
window.addEventListener("hashchange", function () {
if (window.location.hash.includes("ar")) {
document.querySelector("html").setAttribute("dir", "rtl");
document.querySelector("html").setAttribute("lang", "ar");
document.querySelector("body").classList.add("rtl-lang");
} else {
document.querySelector("html").setAttribute("dir", "ltr");
document.querySelector("html").setAttribute("lang", "en");
document.querySelector("body").classList.remove("rtl-lang");
}
});
</script>
</body>
</html>
1 change: 1 addition & 0 deletions docs/intro-to-oss/_navbar.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,4 @@
- Languages
- [:us: English](/intro-to-oss/)
- [:fr: French](/intro-to-oss/translations/fr/)
- [:egypt: Arabic](/intro-to-oss/translations/ar/)
91 changes: 91 additions & 0 deletions docs/intro-to-oss/translations/ar/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
<div align="center" style="text-align: center;">
<div style="display: flex; align-items: center; justify-content: center;">
<h1 style="font-size: 3em; font-family: 'Arial', sans-serif; font-weight: bold; margin: 25px 0;">Intro to Open Source with <span style="background: linear-gradient(to right, #e74c3c, #e67e22); -webkit-background-clip: text; color: transparent;"> OpenSauced
</span> </h1>
</div>
</div>

Welcome to the Intro to Open Source Course with OpenSauced! This course is designed to provide you with an introduction to open source and guide you through the process of contributing to open source projects.

## Language Support

Like pizza, open source is meant to be shared with everyone. We provide and maintain translations in languages below as our official translations:

- [French](./translations/fr/README.md)

For translations in other languages that are maintained by our community, please go to the [Community Translations](../community-translations.md) section.

## Course Overview

The course is divided into chapters, each covering a different aspect of open source:

### [Intro](intro.md)

This chapter sets the stage for your open source journey and discusses prerequisites, objectives, and expectations.

### [What is Open Source?](what-is-open-source.md)

This chapter provides an introduction to open source, its history, and its importance in today's software development landscape.

### [Why Open Source?](why-open-source.md)

In this chapter, you'll learn about the benefits of open source software, such as increased collaboration, faster development, and improved quality.

### [Tools to be Successful](tools-to-be-successful.md)

Discover the key tools and platforms necessary for a successful journey in open source development. From Git and GitHub for version control and collaboration to CodeSee for code visualization and VS Code as your code editor, this chapter provides an overview of how to leverage these essential tools.

### [How to Contribute to Open Source](how-to-contribute-to-open-source.md)

This chapter covers finding projects to work on, submitting contributions, onboarding contributors to new projects, and the outcomes after submitting contributions. Tips for finding projects include browsing GitHub and GitLab, following personal interests, joining open source communities, and utilizing platforms like OpenSauced.

### [The Secret Sauce](the-secret-sauce.md)

This chapter focuses on providing lesser-known strategies and tips for making a lasting impact in the open source community. This chapter provides strategies for finding issues, gaining traction in your open source journey, and leveraging OpenSauced to build your open source resume.

### [Types of Open Source Contributions](types-of-contributions.md)

This chapter explains the non-coding and coding types of contributions involved with open source projects.

### Additional Information

As this is the beginning of your open source journey, we've also provided additional information in these chapters:

- [Glossary](glossary.md): A glossary of common terms and definitions used in open source.
- [Additional Resources](additional-resources.md): A list of resources for further learning about open source, including blog posts, tutorials, and guides.

## Getting Started

If you are taking this course on our GitHub repository, navigate to the [`intro.md` file](intro.md) to start the course. Alternatively, visit the [Intro to Open Source with OpenSauced on the website](https://intro.opensauced.pizza/#/intro-to-oss/) and start reading!

?> **Tip:** Each chapter builds on the previous one, so we recommend reading them in order.

As you work through the course, we encourage you to experiment with the tools and concepts covered in each chapter. The best way to learn is by doing, so try contributing to an open source project or building your project from scratch!

## Building Your Open Source Resume

One of the unique features of this course is that it guides you to build your open source resume using OpenSauced. OpenSauced is a platform that helps you track and showcase your open source contributions, making it easier to get noticed by potential employers and collaborators.

To learn more about using OpenSauced to build your open source resume, check out the "[Building Your Open Source Resume](the-secret-sauce.md#building-your-open-source-resume)" section in "The Secret Sauce" chapter.

---

We hope you find this course informative and useful! If you have any questions or feedback, please don't hesitate to open an issue or reach out to us in the [OpenSauced community Discord](https://discord.com/invite/U2peSNf23P).

Happy learning and contributing!

---

## 🤝 Contributing to this Repository

We encourage you to contribute to OpenSauced! All contributors are required to abide by our [Code of Conduct](https://github.com/open-sauced/.github/blob/main/CODE_OF_CONDUCT.md). Please check out the [Contributing Guidelines](../CONTRIBUTING.md) for information on how to contribute.

If you want to translate our Intro to Open Source course, check out our [🌐 i18n Guidelines](../i18n-guidelines.md).

## ⚖️ LICENSE

[![Creative Commons License](https://i.creativecommons.org/l/by/4.0/88x31.png)](https://creativecommons.org/licenses/by/4.0/)

<footer>
<a href="https://github.com/open-sauced/intro/blob/main/docs/intro-to-oss/README.md">✏️ Edit this page</a>
</footer>
8 changes: 8 additions & 0 deletions docs/intro-to-oss/translations/ar/_navbar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
- [الصفحة الرئيسية](../../README.md)
- الكورسات المتاحة
- [مقدمة إلي الopen source](/intro-to-oss/README.md)
- [كيف تصبح مشرفا](/becoming-a-maintainer/README.md)
- اللغات
- [:us: الإنجليزية](/intro-to-oss/)
- [:fr: الفرنسية](/intro-to-oss/translations/fr/)
- [:egypt: العربية](/intro-to-oss/translations/ar/)
13 changes: 13 additions & 0 deletions docs/intro-to-oss/translations/ar/_sidebar.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
[![صورة OpenSauced](../../../_assets/images/logo-on-dark.png)](https://opensauced.pizza/)

- Intro to Open Source
- [Introduction to Open Source](intro.md)
- [What is Open Source?](what-is-open-source.md)
- [Why Open Source?](why-open-source.md)
- [Tools to be Successful](tools-to-be-successful.md)
- [How to Contribute to Open Source](how-to-contribute-to-open-source.md)
- [The Secret Sauce](the-secret-sauce.md)
- [Types of Open Source Contributions](types-of-contributions.md)
- [Conclusion](conclusion.md)
- [Additional Resources](additional-resources.md)
- [Glossary](glossary.md)
Loading
Loading