Re: Translation questions

Hi Mohamad,

Yes, the document source in AsciiDoc format are available.  Read
through the FDP Primer for details.  It's all in there.

https://docs.freebsd.org/en/books/fdp-primer/

Again, be sure to read through the translation chapters (8, 9, 10) to
get a sense of how it all works.

Best Regards,
Jim B.







On Sat, 12 Apr 2025 15:51:01 -0700
Sayed Mohammad Badiezadegan <mbzadegan@gmail.com> wrote:

> Hello Jim,
> 
> Thank you so much for your response. This is exactly what I am
> looking for. I have much experience using the LaTeX for my old
> Mathematics article, but I found that AsciiDoc should be easier to
> use, especially for documentation.
> 
> Are the FreeBSD documents' source (in AsciiDoc format) available to
> download so that I can write corresponding translated sentences with
> the same template format? I want Persian readers to sense more
> FreeBSD document structure.
> 
> Thank you again for your time.
> 
> 
> 
> On Sat, Apr 12, 2025 at 2:26 PM jpb <jpb@jimby.name> wrote:
> 
> > On Sat, 12 Apr 2025 13:47:08 -0700
> > Sayed Mohammad Badiezadegan <mbzadegan@gmail.com> wrote:
> >  
> > > Hello,
> > >
> > > This is Mohamad,
> > >
> > > I'm interested in translating the FreeBSD documents to my native
> > > language (Persian).
> > >
> > > I saw the list of your available translations, but the Iran BSD
> > > User Group is not active now, and there is no Persian document
> > > available on your website.
> > >
> > > I have 3 questions about the process:
> > >
> > > *1. Is there any template (for example, LaTeX or MS. Word,..)
> > > available that I can use for my translation?*
> > >
> > > *2. How can I get the FreeBSD official email (***@freebsd.org
> > > <http://freebsd.org>) to communicate with my readers?*
> > >
> > > *3. I also wrote a book recently about FreeBSD customization for
> > > HPC systems for free (available by scanning the following barcode
> > > in my signature). Is it possible to publish it on the FreeBSD
> > > official website?*
> > >
> > > I would appreciate your valuable time and consideration.
> > >
> > > Best regards,
> > >
> > >  
> >
> > Hello Mohamad,
> >
> > Thanks for your interest in FreeBSD!  Yes, you can work on
> > translating the FreeBSD documentation set into Persian.
> >
> > To get started, please read through the FreeBSD Documentation
> > Project Primer for New Contributors available here:
> >
> > https://docs.freebsd.org/en/books/fdp-primer/
> >
> > Pay special attention to the translation chapters - I'm sure they
> > will be of interest to you.
> >
> > There are several actions to take in getting software installed on
> > your system to be able to edit and translate documentation.
> >
> > The documentation set is written in AsciiDoctor, so you will want to
> > become familiar with using that.  The project also uses git for
> > downloading and managing a local repository.
> >
> > There is also a Discord server used by many teams - here is an
> > invite:
> >
> > https://discord.gg/d3pjPbzM
> >
> > Many people hang out in the #lobby channel for a wide variety of
> > discussions, but there are other channels you can explore.
> >
> > Welcome aboard.
> >
> > Best Regards,
> > Jim B.
> > jpb@jimby.name
> >