హ్యూగోను అప్‌గ్రేడ్ చేయడంపై కొన్ని గమనికలు

హెచ్చరిక: ఇది చాలా బోరింగ్ యక్షవింగ్ గురించిన పోస్ట్, బహుశా హ్యూగోను చాలా పాత వెర్షన్ నుండి కొత్త వెర్షన్‌కి అప్‌గ్రేడ్ చేయడానికి ప్రయత్నిస్తున్న వ్యక్తులకు మాత్రమే ఆసక్తి ఉంటుంది. అయితే చాలా బోరింగ్ యక్షవేలను ఎప్పటికప్పుడు డాక్యుమెంట్ చేయకపోతే బ్లాగులు దేనికి?

కాబట్టి నిన్న నేను హ్యూగోను అప్‌గ్రేడ్ చేయడానికి ప్రయత్నించాలని నిర్ణయించుకున్నాను. దీన్ని చేయడానికి అసలు కారణం లేదు – నేను 2018 నుండి ఈ బ్లాగ్‌ని రూపొందించడానికి హ్యూగో వెర్షన్ 0.40ని ఉపయోగిస్తున్నాను, ఇది బాగా పని చేస్తుంది మరియు దానితో నాకు ఎలాంటి సమస్యలు లేవు. కానీ నేను అనుకున్నాను – బహుశా నేను అనుకున్నంత కష్టంగా ఉండకపోవచ్చు మరియు నేను కొన్నిసార్లు ఒక దుర్భరమైన కంప్యూటర్ పనిని ఇష్టపడతాను!

ఈ నిర్దిష్ట మైగ్రేషన్‌ని చేయడం ఎవరికైనా ఉపయోగకరంగా ఉంటే, నేను నేర్చుకున్న వాటిని డాక్యుమెంట్ చేయాలని అనుకున్నాను. నేను హ్యూగో v0.40 (2018 నుండి) నుండి v0.135కి (2024 నుండి) అప్‌గ్రేడ్ చేసాను.

నేను చేయాల్సిన చాలా మార్పులు ఇక్కడ ఉన్నాయి:

మార్చు 1: template "theme/partials/thing.html ఇప్పుడు ఉంది partial thing.html

నేను కొన్ని ఉదాహరణలను భర్తీ చేయాల్సి వచ్చింది {{ template "theme/partials/header.html" . }} తో {{ partial "header.html" . }}.

ఇది v0.42లో జరిగింది:

మేము ఇప్పుడు ప్రాజెక్ట్ మరియు థీమ్ ఫైల్‌ల కోసం ఫైల్‌సిస్టమ్‌లను వర్చువలైజ్ చేసాము. ఇది ప్రతిదీ సులభతరం చేస్తుంది, వేగంగా మరియు మరింత శక్తివంతమైనది. కానీ {{ టెంప్లేట్ “theme/partials/pagination.html” ఫారమ్‌లో టెంప్లేట్ లుకప్‌లు అని కూడా దీని అర్థం. }} ఇకపై పని చేయదు. ఆ వాక్యనిర్మాణం ఎప్పుడూ డాక్యుమెంట్ చేయబడలేదు, కాబట్టి ఇది విస్తృత ఉపయోగంలో ఉంటుందని ఆశించబడదు.

మార్పు 2: .Data.Pages ఇప్పుడు ఉంది site.RegularPages

ఇది 0.57.2 విడుదల గమనికలలో చర్చించబడినట్లు కనిపిస్తోంది

నేను భర్తీ చేయాల్సి వచ్చింది .Data.Pages తో site.RegularPages హోమ్‌పేజీలోని టెంప్లేట్‌లో అలాగే నా RSS ఫీడ్ టెంప్లేట్‌లో.

మార్పు 3: .Next మరియు .Prev పల్టీలు కొట్టింది

నేను తదుపరి/మునుపటి బ్లాగ్ పోస్ట్‌కి లింక్ చేసే నా థీమ్‌లో ఈ వ్యాఖ్యను కలిగి ఉన్నాను:

హ్యూగోలో “తదుపరి” మరియు “మునుపటి” అనే పదాలు స్పష్టంగా నేను వారు అకారణంగా అర్థం చేసుకుంటారని భావించే దానికి విరుద్ధంగా అర్థం. నేను “తదుపరి” అంటే “భవిష్యత్తులో” మరియు “మునుపటి” అంటే “గతంలో” అని అర్ధం కావాలని నేను ఆశిస్తున్నాను, కానీ అది వ్యతిరేకం

వారు దీనిని ad705aac064లో మార్చినట్లు కనిపిస్తోంది, తద్వారా “తదుపరిది” వాస్తవానికి భవిష్యత్తులో మరియు “మునుపటి” వాస్తవానికి గతంలో ఉంటుంది. నేను ఖచ్చితంగా కొత్త ప్రవర్తనను మరింత స్పష్టమైనదిగా భావిస్తున్నాను.

స్క్రిప్ట్‌తో హ్యూగో చేంజ్‌లాగ్‌లను డౌన్‌లోడ్ చేస్తోంది

ఈ మార్పులన్నీ ఎందుకు/ఎప్పుడు సంభవించాయో గుర్తించడం కొంచెం కష్టమైన పని. నేను github నుండి చేంజ్‌లాగ్‌లన్నింటినీ టెక్స్ట్ ఫైల్‌లుగా డౌన్‌లోడ్ చేయడానికి ఒక బాష్ స్క్రిప్ట్‌ను కలిసి హ్యాకింగ్ చేసాను, ఏమి జరిగిందో గుర్తించడానికి నేను ప్రయత్నించగలను. GitHub API నుండి అన్ని చేంజ్‌లాగ్‌లను పొందడం చాలా సులభం అని తేలింది.

ఇప్పటివరకు ప్రతిదీ అంత చెడ్డది కాదు – వర్గీకరణల చుట్టూ కూడా మార్పు ఉంది, అది నేను పూర్తిగా వివరించలేను, కానీ ఇది చాలా అందంగా నిర్వహించదగినది, కానీ మేము నిజంగా కఠినమైనదానికి చేరుకున్నాము: మార్క్‌డౌన్ రెండరర్.

మార్పు 4: మార్క్‌డౌన్ రెండరర్ (బ్లాక్‌ఫ్రైడే -> గోల్డ్‌మార్క్)

బ్లాక్‌ఫ్రైడే మార్క్‌డౌన్ రెండరర్ (ఇది గతంలో డిఫాల్ట్‌గా ఉండేది) v0.100.0లో తీసివేయబడింది. ఇది చాలా సహేతుకమైనదిగా అనిపిస్తుంది:

ఇది చాలా కాలంగా నిలిపివేయబడింది, దీని v1 వెర్షన్ ఇకపై నిర్వహించబడదు మరియు చాలా తెలిసిన సమస్యలు ఉన్నాయి. గోల్డ్‌మార్క్ ఇప్పుడు పరిపక్వ స్థానంలో ఉండాలి.

నా మార్క్‌డౌన్ మార్పులన్నింటినీ పరిష్కరించడం చాలా బాధాకరం – నేను 80 వేర్వేరు మార్క్‌డౌన్ ఫైల్‌లను (700లో) అప్‌డేట్ చేయాల్సి వచ్చింది, తద్వారా అవి సరిగ్గా రెండర్ అవుతాయి మరియు నాకు పూర్తిగా తెలియదు

రెండరర్‌లను మార్చడంలో ఎందుకు ఇబ్బంది పడతారు?

ఇక్కడ స్పష్టమైన ప్రశ్న ఏమిటంటే – నేను మార్క్‌డౌన్ రెండరర్‌లను మార్చవలసి వస్తే హ్యూగోను అప్‌గ్రేడ్ చేయడానికి ప్రయత్నించడం ఎందుకు? నా పాత సైట్ పూర్తిగా బాగానే నడుస్తోంది మరియు అది అవసరం లేదని నేను భావిస్తున్నాను మంచి
సమయాన్ని ఉపయోగించడం, కానీ భవిష్యత్తులో ఇది ఉపయోగకరంగా ఉంటుందని నేను భావిస్తున్న ఒక కారణం ఏమిటంటే, కొత్త రెండరర్ (గోల్డ్‌మార్క్) కామన్‌మార్క్ మార్క్‌డౌన్ ప్రమాణాన్ని ఉపయోగిస్తుంది, ఇది కొంత భవిష్యత్తుకు తగినదిగా ఉంటుందని నేను ఆశిస్తున్నాను. కాబట్టి నేను మళ్ళీ దీని ద్వారా వెళ్ళనవసరం లేదు? మేము చూస్తాము.

కొత్త గోల్డ్‌మార్క్ రెండరర్ స్మార్ట్ కోట్‌లతో మరియు లిస్ట్‌లు/బ్లాక్‌కోట్‌లు ఎలా ఇంటరాక్ట్ అవుతాయి అనే దానితో నాకు ఉన్న కొన్ని సమస్యలను (కానీ నేను కలిగి ఉన్నాను అని నాకు తెలియదు) పరిష్కరిస్తుంది.

అన్ని మార్క్‌డౌన్ సమస్యలను కనుగొనడం: ప్రక్రియ

ఈ మార్క్‌డౌన్ మార్పు యొక్క కఠినమైన భాగం ఏమి మారిందో కూడా గుర్తించడం. దాదాపు అన్ని సమస్యలు (ఎగువ #2 మరియు #3తో సహా) కేవలం సైలెంట్‌గా సైట్‌ను విచ్ఛిన్నం చేశాయి, అవి ఏవైనా లోపాలు లేదా దేనికీ కారణం కాలేదు. కాబట్టి నేను వాటిని వేటాడేందుకు HTMLని వేరు చేయాల్సి వచ్చింది.

నేను ముగించినది ఇక్కడ ఉంది:

1. పాత సంస్కరణతో సైట్‌ను రూపొందించండి, దాన్ని ఉంచండి public_old
2. కొత్త వెర్షన్‌ను రూపొందించండి, దాన్ని ఉంచండి public
3. ప్రతి ఒక్క HTML ఫైల్‌ను వేరు చేయండి public/ మరియు public_old ఈ diff.sh స్క్రిప్ట్‌తో మరియు ఫలితాలను a లో ఉంచండి diffs/ ఫోల్డర్
4. వైవిధ్యాలను అమలు చేయండి find diffs -type f | xargs cat | grep -C 5 '(31m|32m)' | less -r నేను తప్పుగా అనిపించేదాన్ని కనుగొనే వరకు ప్రతి ఒక్క మార్పును మళ్లీ మళ్లీ చూడడానికి
5. సమస్యను పరిష్కరించడానికి మార్క్‌డౌన్‌ను నవీకరించండి
6. అంతా ఓకే అనిపించే వరకు రిపీట్ చేయండి

(ది grep 31m|32m విషయం తేడాలో ఎరుపు/ఆకుపచ్చ వచనం కోసం వెతుకుతోంది)

ఇది చాలా సమయం తీసుకుంటుంది, కానీ కొన్ని కారణాల వల్ల కొంచెం సరదాగా ఉంది కాబట్టి చాలా భయంకరమైనది ఏమీ మిగిలి లేదని అనిపించే వరకు నేను దీన్ని చేస్తూనే ఉన్నాను.

కొత్త మార్క్‌డౌన్ నియమాలు

నేను చేయాల్సిన ప్రతి రకమైన మార్క్‌డౌన్ మార్పుల జాబితా ఇక్కడ ఉంది. ఇవన్నీ నాకు చాలా నిర్దిష్టంగా ఉండే అవకాశం ఉంది, కానీ వాటన్నింటిని గుర్తించడానికి నాకు చాలా సమయం పట్టింది కాబట్టి భవిష్యత్తులో దీన్ని కనుగొనే మరొక వ్యక్తికి ఇది ఉపయోగకరంగా ఉండవచ్చు.

4.1: HTML మరియు మార్క్‌డౌన్ కలపడం

ఇది ఇకపై పని చేయదు (ఇది లింక్‌ను విస్తరించదు):

(a link)(https://example.com)

బదులుగా నేను దీన్ని చేయాలి:

(a link)(https://example.com)

ఇది కూడా పని చేస్తుంది:

 (a link)(https://example.com) 

4.2: << “గా మార్చబడింది

నాకు ఇది అక్కరలేదు కాబట్టి నేను కాన్ఫిగర్ చేయాల్సి వచ్చింది:

markup:
  goldmark:
    extensions:
      typographer:
        leftAngleQuote: '<<'
        rightAngleQuote: '>>'

4.3: సమూహ జాబితాలకు కొన్నిసార్లు 4 స్పేస్ ఇండెంట్‌లు అవసరం

నేను 2 స్పేస్‌ల ద్వారా మాత్రమే ఇండెంట్ చేస్తే, నేను 4 స్పేస్‌లను ఉంచాల్సి వస్తే ఇది ఇకపై సమూహ జాబితాగా అందించబడదు.

1. a
  * b
  * c
2. b

సమస్య ఏమిటంటే అవసరమైన ఇండెంట్ మొత్తం జాబితా మార్కర్ల పరిమాణంపై ఆధారపడి ఉంటుంది. దీని కోసం కామన్‌మార్క్‌లో ఇక్కడ ఒక సూచన ఉంది.

4.4: జాబితాల లోపల బ్లాక్‌కోట్‌లు మెరుగ్గా పని చేస్తాయి

గతంలో ది > quote ఇక్కడ బ్లాక్‌కోట్‌గా రెండర్ చేయలేదు మరియు కొత్త రెండరర్‌తో అది చేస్తుంది.

* something
> quote
* something else

కొత్త రెండరర్‌తో మెరుగ్గా పని చేసే (నేను గమనించని) విరిగిన మార్క్‌డౌన్ సమూహాన్ని నేను కనుగొన్నాను మరియు దానికి ఇది ఒక ఉదాహరణ.

బ్లాక్‌కోట్‌లలోని జాబితాలు కూడా మెరుగ్గా పని చేస్తున్నాయి.

4.5: జాబితాల లోపల శీర్షికలు

ఇంతకుముందు ఇది హెడ్డింగ్‌గా ఇవ్వలేదు, కానీ ఇప్పుడు అది చేస్తుంది. కాబట్టి నేను భర్తీ చేయవలసి వచ్చింది # తో #.

* # passengers: 20

4.6: + లేదా 1) లైన్ ప్రారంభంలో అది జాబితా చేస్తుంది

నేను ఇలా కనిపించేది ఏదో కలిగి ఉంది:

`1 / (1
+ exp(-1)) = 0.73`

బ్లాక్‌ఫ్రైడేతో ఇది ఇలా అన్వయించబడింది:

1 / (1
+ exp(-1)) = 0.73

మరియు గోల్డ్‌మార్క్‌తో ఇది ఇలా అన్వయించబడింది:

`1 / (1

అనుకోకుండా ఏదైనా జరిగితే అదే విషయం 1) ఒక లైన్ ప్రారంభంలో, ఈ మార్క్‌డౌన్ స్నిప్పెట్‌లో వలె

I set up a small Hadoop cluster (1 master, 2 workers, replication set to 
1) on 

దీన్ని పరిష్కరించడానికి నేను లైన్‌ను మళ్లీ చుట్టాలి + మొదటి పాత్ర కాదు.

మార్క్‌డౌన్ ఈ విధంగా ఫార్మాట్ చేయబడింది ఎందుకంటే నేను నా మార్క్‌డౌన్‌ను చాలా 80 అక్షరాలకు చుట్టాను మరియు చుట్టడం చాలా సందర్భోచితంగా లేదు.

4.7: కోడ్ బ్లాక్‌లలో స్మార్ట్ కోట్‌లు లేవు

పాత రెండరర్ (బ్లాక్‌ఫ్రైడే) రీప్లేస్ చేయడం వంటి కోడ్ బ్లాక్‌లలో అవాంఛిత పనులను చేస్తున్న ప్రదేశాలు ఉన్నాయి. ... తో … లేదా కోట్‌లను స్మార్ట్ కోట్‌లతో భర్తీ చేయడం. ఇది జరుగుతుందని నేను గ్రహించలేదు మరియు దాన్ని పరిష్కరించినందుకు నేను చాలా సంతోషంగా ఉన్నాను.

4.8: మెరుగైన కోట్ నిర్వహణ

ఇది రెండర్ చేయబడిన విధానం మెరుగైంది:

"Oh, *interesting*!"

• పాత: “ఓహ్, ఆసక్తికరమైన!“
• కొత్తది: “ఓహ్, ఆసక్తికరమైన!”

ముందు రెండు స్మార్ట్ కోట్‌లు మిగిలి ఉన్నాయి, ఇప్పుడు కోట్‌లు సరిపోలాయి.

4.9: చిత్రాలు ఇకపై a లో చుట్టబడవు p ట్యాగ్

ఇంతకు ముందు నేను ఇలాంటి చిత్రాన్ని కలిగి ఉంటే:

అది ఒక చుట్టి వస్తుంది tag, now it doesn’t anymore. I dealt with this
just by adding a margin-bottom: 0.75em CSSలోని చిత్రాలకు, ఆశాజనక అది వాటిని తగినంతగా ప్రదర్శించేలా చేస్తుంది.

markup:
  highlight:
    codeFences: false
  goldmark:
    renderer:
      unsafe: true
    parser:
      autoHeadingIDType: blackfriday