Localize Kubernetes website into Farsi

[SamanKhalife]

This is a Feature Request

Initial minimum-viable Farsi localization.

Hope to add the first live version of Farsi localization for k8s.io
This issue is to (re)initiate Farsi localization efforts based on following actionable items.

Actionable items identified from
https://kubernetes.io/docs/contribute/localization/#start-a-new-localization

• 1. Select the language code for Farsi

• ref:https://kubernetes.io/docs/contribute/localization/#start-a-new-localization

• the language code for Farsi: fa

• 2. Add a slack channel for Farsi

• https://kubernetes.io/docs/contribute/localization/#find-community

• Slack channel for Farsi : #kubernetes-docs-fa

• 3. Add a label for Farsi

• https://kubernetes.io/docs/contribute/localization/#configure-the-workflow

label for Farsi: language/fa

• 4. Localize the community code of conduct

• https://kubernetes.io/docs/contribute/localization/#localize-the-community-code-of-conduct

• code of conduct: https://github.com/cncf/foundation/blob/main/code-of-conduct-languages/fa.md

• 5. Invite candidates for @kubernetes/sig-docs-fa-owners and @kubernetes/sig-docs-fa-reviews

• https://kubernetes.io/docs/contribute/localization/#add-your-localization-team-in-github

• Note: Seeking for Interested Contributors In Farsi localization

• current reviewers: @SamanKhalife

• current approvers: @SamanKhalife

• current team members: @SamanKhalife

• 6. Check the all candidates are the member of the Kubernetes GitHub organization

• https://kubernetes.io/docs/contribute/localization/#join-the-kubernetes-github-organization

• 7. Add a development branch for Farsi localization

• https://kubernetes.io/docs/contribute/localization/#source-files

• https://kubernetes.io/docs/contribute/localization/#branch-strategy

• Note: members of @kubernetes/website-maintainers can create new localization branches to coordinate translation efforts.

• Note: Netlify preview needs to be configured for the dev branch

• 8. Open a PR to configure a localization environment

• Note: base and target branches of the PR should be the dev branch of FA.

  • Add a configuration block for the new language to hugo.toml
  • https://kubernetes.io/docs/contribute/localization/#modify-the-site-configuration
  • Add a new localization directory
  • https://kubernetes.io/docs/contribute/localization/#add-a-new-localization-directory
  • Add and localize site strings in i18n
  • https://kubernetes.io/docs/contribute/localization/#site-strings-in-i18n
  • Set up the OWNERS files based on the candidate list
  • https://kubernetes.io/docs/contribute/localization/#set-up-the-owners-files
  • Check build test and site-preview of the PR

• 9. Open PRs to localize all minimum-required-contents and a localized README file

• https://kubernetes.io/docs/contribute/localization/#minimum-required-content

• https://kubernetes.io/docs/contribute/localization/#add-a-localized-readme-file

• Note: base and target branches of the PR should be the dev branch of FA.

• 10. Open a PR to merge the dev branch into

• https://kubernetes.io/docs/contribute/localization/#launch-your-new-localization

  • Check build test and site-preview of the PR

/language fa

[k8s-ci-robot]

This issue is currently awaiting triage.

SIG Docs takes a lead on issue triage for this website, but any Kubernetes member can accept issues by applying the triage/accepted label.

The triage/accepted label can be added by org members by writing /triage accepted in a comment.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[dipesh-rawat]

/area localization

[sftim]

Invite candidates for @kubernetes/sig-docs-ar-owners and @kubernetes/sig-docs-ar-reviews

This doesn't sound right. Did you mean @kubernetes/sig-docs-fa-owners and @kubernetes/sig-docs-fa-reviews?

[SamanKhalife]

Hi @sftim,

Thank you very much for your feedback.

I've edited the issue to correctly refer to the appropriate groups. Now it specifies @kubernetes/sig-docs-fa-owners and @kubernetes/sig-docs-fa-reviews for the localization of the Kubernetes website into Farsi.

[seokho-son]

Hi @SamanKhalife,

I believe #22565 is the first attempt at Farsi localization (https://github.com/kubernetes/website/tree/dev-1.18-fa.1).

It seems the initial attempt was not successfully completed at that time, and the Slack channel #kubernetes-docs-fa has been inactive.

We need to recruit enough contributing members to make it active again! :)

Could you help bring more contributors who are interested and willing to devote their efforts to this project?