Ka-hortagga agabka waxbarashada inay noqdaan kuwo duugoobay

Si kooban oo ku saabsan xaaladda jaamacadaha (waayo-aragnimada shakhsi ahaaneed)

Si aad u bilawdo, waxaa habboon in la qeexo in walxaha la soo bandhigay uu yahay mid shakhsi ahaaneed, si loo hadlo, "aragti gudaha ah," laakiin waxay dareemeysaa in macluumaadka ay ku habboon yihiin jaamacado badan oo dawladeed oo ku yaala booska ka dambeeya Soviet.

Baahida loo qabo khabiirada IT-ga awgeed, machadyo badan oo waxbarasho ayaa furay goobo tababar oo khuseeya. Intaa waxaa dheer, xitaa ardayda aan takhasuska IT-ga ahayn waxay heleen maaddooyin badan oo IT-ga la xiriira, badanaa Python, R, halka kuwa nasiibka yar ay tahay inay bartaan luqadaha tacliinta "boodhka" sida Pascal.

Haddii aad si qoto dheer u eegto, wax walba maahan mid fudud. Dhammaan macalimiintu kuma socdaan "isbeddellada". Shakhsi ahaan, markii aan baranayey takhasuska "barnaamijka", waxaan la kulmay xaqiiqda ah in macallimiinta qaarkood aysan haysan qoraallo muxaadaro ah oo casri ah. Si aad u noqoto mid sax ah, macalinku wuxuu madaxa u diray sawir qoraal ah oo ay arday qaarkood gacanta ku qoreen flash drive. Waxaan gabi ahaanba ka aamusay muhiimada agabka sida buugaag ku saabsan barnaamijyada WEB (2010). Waxa kale oo laga tagay in la qiyaaso waxa ka dhacaya dugsiyada farsamada iyo kii ugu xumaa xarumaha waxbarashada.

Soo koobid:

• Waxay daabacaan macluumaad badan oo aan khusayn iyagoo raadinaya tilmaamayaasha tacliineed ee tirada;
• Siidaynta agabka cusub waa mid aan habaysanayn;
• "Trendy" iyo faahfaahinta hadda jirta ayaa inta badan la tebayaa jaahilnimada fudud awgeed;
• Jawaab celinta qoraagu way adag tahay;
• Daabacaad la cusboonaysiiyay ayaa si naadir ah oo aan joogto ahayn loo daabacaa.

"Haddii aadan aqbalin, dhaleeceyn, haddii aad dhaleeceyso, soo jeedi..."

Waxa ugu horreeya ee maskaxda ku soo dhaca waa hirgelinta nidaamyada mashiinka ku salaysan Warbaahinta wiki. Haa, haa, qof kastaa wuu maqlay Wikipedia, laakiin waxay leedahay dabeecad tixraaceed encyclopedic. Waxaan aad u xiisaynaa agabka waxbarashada. Wikibooks nagu habboon si fiican. Khasaarooyinka waxaa ka mid ah:

• furnaanta qasabka ah ee dhammaan agabka (xigasho: "Halkan deegaanka wiki, suugaanta waxbarashada si wadajir ah ayaa loo qoraa, loo qaybiyaa si xor ah oo loo heli karo qof walba.")
• joogitaanka qaar ka mid ah ku tiirsanaanta xeerarka goobta, kala sareynta gudaha ee isticmaalayaasha
  Waxaa jira matoorro badan oo wiki ah oo sabbaynaya goobta dadweynaha, laakiin waxaan u maleynayaa inaysan jirin baahi loo qabo xitaa in la bilaabo ka hadalka suurtagalnimada in la geeyo nidaamka wiki ee heerka jaamacadeed. Waayo-aragnimada waxa aan odhan doonaa: a) Xalka is-xilqaan ee noocan oo kale ah ayaa la ildaran dulqaadka khaladka; b) waxaad illoobi kartaa cusbooneysiinta nidaamka (marka laga reebo kuwa aad dhif u ah).

Muddo dheer ayaan ku fikiray in aan waxba ka tari karin sidii aan xaaladda u hagaajin lahaa. Kadibna maalin maalmaha ka mid ah nin aqoon u leh ayaa sheegay in wakhti dheer ka hor uu daabacay buug qabyo ah oo ku saabsan A4, laakiin lumiyay nooca elektarooniga ah. Waxaan xiisaynayay sida loogu beddelo dhammaan qaab elektaroonig ah.

Kani waxa uu ahaa buug-waxbarasho oo leh tiro badan oo qaacido iyo garaafyo ah, qalabyada OCR ee caanka ah, sida. abbyy finereader, badh kaliya ayaa caawiyay. Finereader waxa uu soo saaray qaybo qoraal ah, kaas oo aanu bilownay inaanu galno galalka qoraalka caadiga ah, anagoo u qaybinayna cutubyo, oo wax walba ku calaamadinaynay MarkDown. Sida cad loo isticmaalo git si loo fududeeyo wada shaqaynta. Sida kayd fog ayaanu isticmaalnay BitBucket, sababtu waxay ahayd awoodda lagu abuuro kayd gaar ah oo leh qorshe tariif bilaash ah (tani sidoo kale waa run GitLab). Loo helay gelinta caanaha caanaha Mathpix. Marxaladdan, waxaan ugu dambeyntii u leexannay dhanka "MarkDown + LaTeX", maadaama qaababka loo beddelay LaTeX. Si aan pdf ugu badalno waxaan isticmaalnay Pandoc.

Muddo ka dib, tifaftiraha fudud ee qoraalka kuma filna, sidaas darteed waxaan bilaabay inaan raadiyo beddelka. Isku day Typora iyo dhowr barnaamij oo kale oo la mid ah. Natiijo ahaan, waxaan u nimid xal webka oo aan bilownay isticmaalka is dulsaaran, Wax kasta oo aad u baahan tahay ayaa meeshaas ku jiray, laga soo bilaabo isku xidhka github ilaa taageerada iyo faallooyinka LaTeX.

Si gaar ah, natiijadu waxay tahay, qoraal fudud oo aan ka xishoonayo ayaa la qoray, kaas oo fuliyay hawsha ururinta iyo u beddelka qoraalka la daabacay WEB. Qaab HTML fudud ayaa tan ku filan.
Waa kuwan amarada loogu beddelo WEB:

find ./src -mindepth 1 -maxdepth 1 -exec cp -r -t ./dist {} +
find ./dist -iname "*.md" -type f -exec sh -c 'pandoc "
find ./src -mindepth 1 -maxdepth 1 -exec cp -r -t ./dist {} +
find ./dist -iname "*.md" -type f -exec sh -c 'pandoc "${0}" -s --katex -o "${0::-3}.html"  --template ./temp/template.html --toc --toc-depth 2 --highlight-style=kate --mathjax=https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML' {} ;
find ./dist -name "*.md" -type f -exec rm -f {} ;
" -s --katex -o "${0::-3}.html"  --template ./temp/template.html --toc --toc-depth 2 --highlight-style=kate --mathjax=https://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML' {} ;
find ./dist -name "*.md" -type f -exec rm -f {} ;

Ma samaynayso wax caqli badan, laga bilaabo waxa la xusi karo: waxay ururisaa madaxyada nuxurka si sahlan oo loo beddelo LaTeX.

Waqtigan xaadirka ah waxaa jira fikrad ah in si otomaatig ah loo dhiso marka la samaynayo riixitaanka dib-u-celinta github, iyadoo la adeegsanayo adeegyada isdhexgalka joogtada ah (Circle CI, Travis CI..)

Ma jiraan wax cusub...

Anigoo xiiseeya fikradan, waxaan bilaabay inaan raadiyo sida ay caan u tahay hadda.
Way iska cadayd in fikraddani aanay ku cusbayn dukumentiyada software-ka. Waxaan arkay dhowr tusaale oo ah agab waxbarasho oo loogu talagalay barnaamijyada barnaamijka, tusaale ahaan: koorsooyinka JS baro.javascript.ru. Waxaan sidoo kale xiiseynayay fikradda mashiinka wiki-ku-saleysan ee loo yaqaan 'git-based wiki engine' Gollum

Waxaan arkay meelo badan oo buugaag ah oo ku qoran LaTeX.

gunaanad

Arday badan ayaa dhowr jeer dib u qoraa qoraallo, kuwaas oo ay hore u qoreen marar badan, marar badan oo hore (ma is weydiinayo faa'iidada qoraalka gacanta), mar kasta oo macluumaadka la waayo oo si tartiib ah loo cusbooneysiiyo, dhammaan qoraallada, sida aan fahamsanahay, kuma jiraan. qaab elektaroonik ah. Natiijo ahaan, way fiicnaan lahayd in qoraallada lagu dhejiyo github (loo beddelo pdf, aragtida shabakadda), oo macallimiinta la siiyo inay sidaas oo kale sameeyaan. Tani waxay, ilaa xad, soo jiidan doontaa ardayda iyo macalimiinta tartanka "nool" ee bulshada GitHub, iyada oo aan la xusin kordhinta tirada macluumaadka la nuugo.

Tusaale ahaan Waxa aan uga tagayaa xidhiidhka cutubka koowaad ee buugga aan ka hadlayay, waa tan waana kan isku xirka rap.

Source: www.habr.com