ஆவணங்கள் கருவிகள் செயல்விளக்கம்¶
தலைப்பு சரிபார்ப்புப் பட்டியல்¶
இந்த டெமோ, BeeWare MkDocs மெட்டீரியல் தீம் ஓவர்ரைடுகளின் பல்வேறு அம்சங்களைச் சோதிப்பதற்காக வடிவமைக்கப்பட்டுள்ளது. தயவுசெய்து இந்த மற்றும் அடுத்தடுத்த பக்கங்களில் பட்டியலிடப்பட்டுள்ள அனைத்தும், விளக்கத்தில் விவரிக்கப்பட்டுள்ளபடி இருப்பதையும், செயல்படுவதையும் சரிபார்க்கவும்.
தலைப்புப் பட்டை¶
பக்கத்தில் ஒரு நடுத்தர சாம்பல் நிற தலைப்புப் பட்டை உள்ளது. இந்த கருப்பொருள் வார்ப்புரு பயன்படுத்தப்பட்டுள்ளது.
தலைப்புச் சின்னம்¶
மேல்-இடது மூலையில் உள்ள ஹெட்டர் ஐகான் காட்டப்பட்டுள்ளது. இது, டெம்ப்ளேட் வெளிப்புற வளங்களைக் குறிப்பிட முடியும் என்பதை உறுதிப்படுத்துகிறது.
முகப்புப் பக்கப் பக்கப்பட்டைச் சின்னம்¶
இடது பக்கப் பக்கப்பட்டியில் உள்ள சின்னம் காட்டப்பட்டுள்ளது. சின்னம் பக்கப்பட்டியின் அகலத்திற்குச் சமமாகவும், அதன் உயரத்திற்குச் சமமாகவும் இருக்க வேண்டும். சின்னம் காட்டப்பட்டதற்குக் கீழே, தளத்தின் தலைப்பு, பக்கப்பட்டியின் மற்ற பகுதிகளில் உள்ளதை விட சற்று பெரிய எழுத்துருவில் காட்டப்பட வேண்டும். அதற்குக் கீழே, பதிப்பு எண் சிறிய எழுத்துருவில் காட்டப்பட வேண்டும்.
இது இலக்கு தளங்களில் பக்கப் பட்டி சரியாகக் காட்டப்படும் என்பதை உறுதிப்படுத்துகிறது.
தலைப்பு எழுத்துரு¶
தலைப்புகள் Cutive-ல் காட்டப்படுகின்றன. இது BeeWare தனிப்பயன் CSS தீம் பயன்படுத்தப்பட்டுள்ளது என்பதை உறுதிப்படுத்துகிறது.
வரிசைக் குறியீடு¶
வரிவழி குறியீடு, சுற்றியுள்ள எழுத்துருவின் அதே நிறத்தில் காட்டப்படுகிறது. இது, தீம் எந்த விரும்பத்தகாத மாற்றங்களையும் ஏற்படுத்தவில்லை என்பதை உறுதிப்படுத்துகிறது.
இது inline code மற்றும் inline code உடன் கூடிய உரை.
தாவல் உள்ளடக்கக் குறியீடு¶
குறியீடு பின்னணியில் இருந்து மாறுபட்ட நிறத்தில் இருக்க வேண்டும். நகலெடுக்கும் பொத்தான் கட்டளைகளை மட்டும் நகலெடுக்க வேண்டும்; உரைப் புலம் சேர்க்கப்படக்கூடாது.
இது, தீம் எந்த விரும்பத்தகாத மாற்றங்களையும் ஏற்படுத்தவில்லை என்பதையும், காப்பி பட்டன் எதிர்பார்த்தபடி வேலை செய்கிறதா என்பதையும் உறுதி செய்கிறது.
$ git clone https://github.com/beeware/beeware-theme.git
$ git clone https://github.com/beeware/beeware-theme.git
C:\...>git clone https://github.com/beeware/beeware-theme.git
குறியீடு நகலெடுக்கும் பொத்தானின் செயல்பாடு¶
பின்வரும் குறியீட்டுப் பகுதியில் உள்ள நகலெடு பொத்தானை அழுத்தும்போது, from pathlib import Path கிளிப்போர்டில் நகலெடுக்கப்பட வேண்டும்.
pathlib-இலிருந்து Path-ஐ இறக்குமதி செய்யவும்
பின்வரும் குறியீட்டுப் பிரிவில் உள்ள நகலெடு பொத்தானை அழுத்தும்போது, ls beeware-docs-tools கிளிப்போர்டில் நகலெடுக்கப்பட வேண்டும். ஷெல் உள்வாய்ப்பும் வெளியீடும் சேர்க்கப்படக்கூடாது.
(venv) $ ls beeware-docs-tools
_build locales requirements.dev.txt tox.ini
docs pyproject.toml requirements.docs.txt
LICENSE README.md src
பக்கப் பட்டி இணைப்புகள்¶
பக்கப்பட்டி இணைப்புகள் உள்ளன, அவை beeware-docs-tools ரெப்போவைக் குறிக்கின்றன. இது பக்கப்பட்டி உள்ளடக்கம் ஏற்றப்பட்டுள்ளது என்பதையும், MkDocs உள்ளமைவுக் கோப்பில் project-name அமைக்கப்பட்டுள்ளது என்பதையும், பதிப்பு எண் கணக்கிடப்பட்டு சேர்க்கப்பட்டுள்ளது என்பதையும் உறுதிப்படுத்துகிறது.
இணைப்பு வண்ணங்கள்¶
முதன்மை BeeWare இணையதளத்திற்கான இந்த இணைப்பு இரு ஒளி முறை மற்றும் இருள் முறை இரண்டிலும் நீல நிறத்தில் இருக்க வேண்டும். இந்த இணைப்பு INCLUDES CODE குறியீட்டுடன் கூடிய குறியீட்டு உள்ளடக்கத்திற்கு, நிழலிடப்பட்ட பின்னணியுடன் நீல நிறத்தைப் பயன்படுத்த வேண்டும்.
இடது மற்றும் வலது பக்கப் பட்டைகளில் உள்ள இணைப்புகளும் இரண்டு முறைகளிலும் நீல நிறத்தில் இருக்க வேண்டும்.
பக்கத்தை கீழே ஸ்க்ரோல் செய்யும்போது, வலதுபுறப் பக்கப்பட்டையில் உள்ள செயலில் உள்ள தலைப்பு இணைப்பு, டார்க் மோடில் வெளிர் நீலமாகவும், லைட் மோடில் அடர் நீலமாகவும் இருக்க வேண்டும்.
மொழிபெயர்ப்பு அறிவுரை¶
இந்த ஆவணத்தின் ஆங்கிலப் பதிப்பில் கீழே "மொழிபெயர்ப்புகள் கிடைக்கின்றன" என்ற எச்சரிக்கை காட்டப்பட வேண்டும். பிரெஞ்சு மொழிபெயர்ப்பில் "இது ஒரு இயந்திர மொழிபெயர்ப்பு!" என்ற எச்சரிக்கை காட்டப்பட வேண்டும். மனித மொழிபெயர்ப்புகளுக்கு, ஜெர்மன் மொழிபெயர்ப்பில் "இது ஒரு மொழிபெயர்ப்பு!" என்ற எச்சரிக்கை காட்டப்பட வேண்டும்.
இது ஒரு இயந்திர மொழிபெயர்ப்பு!
இந்தப் பயிற்சியின் பதிப்பு இயந்திர மொழிபெயர்ப்பு மூலம் உருவாக்கப்பட்டது. இது சிறந்ததல்ல என்பதை நாங்கள் அறிவோம், ஆனால் மொழிபெயர்ப்பே இல்லாததை விட ஒரு மோசமான மொழிபெயர்ப்பு பரவாயில்லை என்று நாங்கள் கருதினோம்.
தனிப்பயன் 404 பக்கம்¶
உங்கள் உலாவியில் உள்ள URL-இன் முடிவில் nopage என்பதைச் சேர்ப்பதன் மூலம், 404 பக்கம் உள்ளது என்பதையும், அதில் "Brutus can't find what you're looking for" என்ற உரை உள்ளது என்பதையும் சரிபார்க்கலாம். MkDocs-இல் உள்ள ஒரு சிக்கல் காரணமாக, தற்போதைய 404 பக்கம் எப்போதும் படங்களைக் காட்டவில்லை.
அடையாளம் தெரியாத உள் இணைப்புகளால் MkDocs உருவாக்கம் தோல்வியடைகிறது, எனவே உங்கள் உலாவியில் URL-ஐ மாற்றுவதன் மூலம் இந்தச் சரிபார்ப்பை நீங்கள் கைமுறையாகச் சரிபார்க்க வேண்டும்.
அடுத்த சோதனைகள்¶
பின்வரும் இணைப்பு உங்களை பீவேர் டாக்குஸ் டூல்ஸ் டெமோ பிரிவு ஒன்றுக்கு அழைத்துச் செல்லும். பக்கங்களுக்கு இடையேயான இணைப்பைச் சரிபார்க்க இது சேர்க்கப்பட்டுள்ளது.
அடுத்த சோதனைகளுக்கு BeeWare Docs Tools Demo Section One-க்குச் செல்லவும்.