Skip to content

Add Persian translation for "Getting Started" and update structure #5

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

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

Zahra-khanzadeh
Copy link
Contributor

Hi @mmcky ,
This PR includes the Persian translation of the “Getting Started” lecture.

In addition to that, I’ve made a few updates:
Adjusted the heading levels in both about_py.md and the new getting_started.md file to match the English version’s structure.
Added proper internal links for all referenced words, following the format used in the original lectures.
Organized the images folder by creating separate subfolders for each lecture to keep things tidy and consistent going forward.

I’d also love to preview everything before it goes live, if that’s possible!

One small thing I noticed — the section numbers in the rendered version still appear in English. Would it be possible to switch them to Persian digits in the theme?

Let me know if anything needs to be adjusted — thank you so much again for all your support!

Copy link

netlify bot commented May 12, 2025

Deploy Preview for majestic-griffin-10b166 ready!

Name Link
🔨 Latest commit 0bd31d7
🔍 Latest deploy log https://app.netlify.com/sites/majestic-griffin-10b166/deploys/6822dc11e38fa100083c609d
😎 Deploy Preview https://deploy-preview-5--majestic-griffin-10b166.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@Zahra-khanzadeh
Copy link
Contributor Author

Dear @mmcky,

I’ve been working on the Persian translation of the “Getting Started” lecture and came across an issue. The images aren’t showing up correctly in the final build, even though they appear fine when previewed locally. It seems the problem might be related to the code-cell and how it’s being processed, as I’m using them for Python code outputs, including images.

I made sure to follow the same structure as the English version of the lectures, particularly for the headers and the use of code cells, to maintain consistency with the other courses. The "Code Cell" format in the markdown has been used in line with the previous course structure.

ChatGPT suggested that the issue could be due to a missing or incorrectly configured Jupytext header. Apparently, the header should include the jupytext section to properly handle the code-cell directives.

Here’s the header it recommended:

jupytext:
text_representation:
extension: .md
format_name: myst
kernelspec:
display_name: Python 3
language: python
name: python3

Could you check if the header is set up correctly in the lecture files? This should help resolve the issue with the images and code cells not rendering properly.

Thanks a lot!

@mmcky
Copy link
Contributor

mmcky commented May 13, 2025

thanks @Zahra-khanzadeh -- I will take a look at this closely tomorrow.

Really appreciate your work on this. I'll be in touch soon.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants