మూస:TeluguTOC/doc
This is a documentation subpage for మూస:TeluguTOC. It may contain usage information, categories and other content that is not part of the original మూస page. |
This is a table-of-contents replacement for alphabetical lists within mainspace articles. The template has all features of other TOC templates, such as optional "Top" "0–9" sections, and allows selecting other sections.
వాడుక
మార్చువిశేషాలు
మార్చు- ఈ మూస, ఇంగ్లీషు అక్షరాలతో ఉండే {{Compact ToC}} కి ప్రత్యామ్నాయంగా, తెలుగు అక్షరాలతో, తెలుగు లింకులతో ఉంటుంది. ఇతర ఉపయోగాలన్నీ యథాతథంగా ఇందులోనూ ఉంటాయి.
- విషయ సూచికలో ఇంగ్లీషు తెలుగు అక్షరాలు రెండూ కావాలనుకుంటే ఈ రెండు మూసలనూ కలిపి ఉపయోగించుకోవాలి
- పేజీలో మామూలుగా ఉండే విషయ సూచికను తీసేస్తుంది. ఈ మూసను వాడిన పేజీలో అది కూడా ఉండాలి అనుకుంటే
__FORCETOC__
గానీ,__TOC__
గానీ వాడాలి. వీటిని వాడే విషయమై మరింత సమాచారం కోసం సహాయం:చమత్కార పదాలు చూడండి. - విషయ సూచిక ఒద్దికగా ఒకదాని పక్కన ఒకటిగా ఉంటుంది: అ ఆ ఇ ఈ ఉ ఊ ....
- అంకెలను కూడా చేర్చడం, సెంటరులో పెట్టడం ఐచ్ఛికాలు: center=yes, num=yes.
- "సూచిక" శీర్షిక పైన ఉంచవచ్చు (default) లేదా ఎడమ పక్కన పెట్టవచ్చు (side=yes).
- అక్షరాల శ్రేణిని అమర్చుకోవచ్చు (కిందచూడండి: #అక్షరాలు): అ ఆ ఇ–ఊ ఋ ౠ-ఎ ఏ...
- కొన్ని అక్షరాలు అక్కర్లేదనుకుంటే వాటిని తీసెయ్యవచ్చు.
- Other headers can be listed in the TOC (see below: #Listing custom headers).
- pre1, pre2, ... pre12 రూపంలో "అఆఇఈ" లకు ముందు ఇతర శీర్షికలను చేర్చుకోవచ్చు .
- custom1, custom2, ... custom12 రూపంలో "అఆఇఈ" ల తరువాత ఇతర శీర్షికలను చేర్చుకోవచ్చు
- Conceal subheader link-text as "pre1name" over "pre1link" and "custom1name" over "custom1link" etc.
- ఇతర విశేషాలు: top=yes, seealso=yes, refs=yes, extlinks=yes, etc.
సింటాక్సు
మార్చు- నమూనా వాడుక
- {{TeluguTOC |symnum=yes}}
- అక్షరాల లింకులు (అంటే.. "అ", "ఆ", … "ఱ") మాత్రమే కావాలనుకుంటే
- {{TeluguTOC}}
- సాధారణంగా వాడే రూపం
- {{TeluguTOC |center=yes |seealso=yes|refs=yes|further=yes}}
ఖాళీ సింటాక్సు
మార్చు{{TeluguTOC
|side=|center=|right=
|name=
|top=
|pre1=|pre1name=|pre1link=
|pre2=|pre2name=|pre2link=
<!--(etc, to:)-->
|pre12=|pre12name=|pre12link=
|prebreak=<!--yes-->
|num= |sym= |symnum=
|letters=
|custom1=|custom1name=|custom1link=
|custom2=|custom2name=|custom2link=
<!--(etc, to:)-->
|custom12=|custom12name=|custom12link=
|nobreak=
|seealso= |refs= |notesfirst=|notes= |further= |extlinks=
|అ=|ఆ= <!--(ఇలా మొదలెట్టి చివరి దాకా:)--> |ఱ=
}}
పరామితులు
మార్చుname=
: change the heading to an alternative name instead of "సూచిక", or hide it completely by enteringname=no
side=yes
: "సూచిక" శీర్షికను ఎడమ వైపున చూపిస్తుంది. పక్కన కోలను కూడా ఉంటుందిcenter=yes
: float TOC centered in the horizontal middle of the page, instead of floated leftright=yes
: align the TOC horizontally to the right of the page (may require<br style="clear:right;" />
after it, depending on page layout), instead of floated left (this parameter is mutually exclusive with the "center" option above, and should be used sparingly and with good reason)nobreak=yes
: అ-ఆ-ఇ-ఈ.. వగైరాలకూ ఇవి కూడా చూడండి/మూలాలు/వగైరా. కూ మధ్య లైన్బ్రేకు ఇవ్వదు (గమనిక: శీర్షికపై ప్రభావమేమీ ఉండదు; దాని కోసంside=
వాడాలి)top=yes
: enable the "Top" link; this is only useful if this copy of the TOC is a secondary TOC not at the top of the page, e.g. in the middle of a long glossary. (Every rendered page has a hidden<a name="top" id="top"></a>
above the sitenotice which makes this link work without having to do anything but enable it in the template.)num=yes
: enable the "0–9" link for numeric entries section (create a heading of==0–9==
for the link to work)sym=yes
: enable the "!$@" link for symbolic entries sectionsymnum=yes
: enable the "!–9" link for combined symbolic and numeric entries section (create a heading of==!–9==
for the link to work)letters=no
: "అ", "ఆ", ..., "ఱ" అక్షరాలను కనబడకుండా చేస్తుంది.pre1
నుండిpre12
దాకా: "అఆఇఈ" ల కంటే ముందు 12 వరకూ అదనపు విభాగ శీర్షికలను చేర్చవచ్చు. ఇవి [[#pre1|pre1]] రూపంలో కనిపిస్తాయి.pre1name
topre12name
: modifies the way the pre-list section headers appear: [[#pre1|pre1name]]pre1link
topre12link
: modifies the targets of the pre-list headers: [[pre1link|pre1]].prebreak=yes
: set break-line after all pre-list headerscustom1
tocustom12
: "అఆఇఈ" ల తరువాత 12 వరకూ అదనపు విభాగ శీర్షికలను చేర్చవచ్చు. ఇవి [[#custom1|custom1]] రూపంలో కనిపిస్తాయి.custom1name
tocustom12name
: modifies the way the custom section headers appear: [[#custom1|custom1name]]custom1link
tocustom12link
: modifies the targets of the custom sections: [[custom1link|custom1]]. Use this only for linking to another page. Use sparingly! About the only legitimate use for this is connecting the sub-pages of multi-page articles, like long lists that have been broken up. Do not repurpose the TOC as a makeshift navbox.seealso=yes
: enable link to the "ఇవి కూడా చూడండి" sectionnotesfirst=yes
: "గమనికలు" విభాగానికి లింకు ఇస్తుంది. దాన్ని "మూలాలు" విభాగం కంటే ముందు చూపిస్తుంది; దీన్ని,notes
నూ కలిపి వాడరాదు (బహువచనం ఉంది, గమనించండి)refs=yes
: "మూలాలు" విభాగానికి లింకు ఇస్తుంది (బహువచనం ఉంది, గమనించండి)notes=yes
: "గమనికలు" విభాగానికి లింకు ఇస్తుంది (బహువచనం ఉంది, గమనించండి))further=yes
: "మరింత చదవడానికి" విభాగానికి లింకు ఇస్తుందిextlinks=yes
: "బయటి లింకులు" విభాగానికి లింకు ఇస్తుందిఅ=
నుండిఱ=
వరకు: ఏ అక్షరం కిందనైనా ఎంట్రీలేమీ లేకపోతే, ఆ అక్షరాన్ని కనబడకుండా చెయ్యడానికి ఇలా = తరువాత ఏమీ ఇవ్వకుండా వదిలెయ్యాలి. అయితే భవిష్యత్తులో ఆ అక్షరం కింద ఎంట్రీలు వస్తే అప్పుడు మళ్ళీ ఈ పరామితిని తీసెయ్యాల్సి ఉంటుంది. కాబట్టి ఈ అంశాన్ని వాడేటపుడు జాగరూకత వహించాలి. ఈ అంశాన్ని వాడి ఒక అక్షరం నుండి మరో అక్షరం దాకా ఉండే శ్రేణిని సృష్టించవచ్చు. ఉదాహరణకు "అ-అః" అనే శ్రేణిని సృష్టించవచ్చు. (సృష్టించడం ఎలాగో కింది విభాగాల్లో చూడండి.)- The equivalent of this for numbers is
0-9=
- note this is a hyphen and not a dash (the heading uses a dash)
- The equivalent of this for numbers is
allowtoc=yes
: disables the hiding of the automatically-generated table of contents that__NOTOC__
usually hides. (Since this template's purpose is usually to replace the existing table of contents, this functionality is usually only necessary on Wikipedia guideline pages that use this template in examples.)
అక్షరాలు
మార్చుఏదైనా అక్షరాన్ని లేకుండా చెయ్యవచ్చు (ఆ అక్షరం కింద ఎంట్రీలేమీ లేని సందర్భంలో). అందుకోసం దాని పేరిట ఒక ఖాళీ పరామితిని ఇవ్వాలి. ఉదాహరణకు, {{TeluguTOC |side=yes |ఙ=|ౙ=}}
:
Note: It is often better to create an empty placeholder span (e.g. <span id="Q"></span>
) where the letter's heading would be in the page if it existed, since in most cases it is quite possible that it will come to exist in the future. Using the span-id avoids confusing readers who might not realize the TOC-template has skipped some letters.
ఇలా అక్షరానికి విలువ ఇచ్చే అంశాన్ని వాడి శ్రేణి లింకులను సృష్టించవచ్చు. ఉదాహరణకు, {{TeluguTOC |side=yes |అ=[[#అ–ఇ|అ–ఇ]] |ఆ=|ఇ=}}
:
కస్టమ్ శీర్షికలను చూపించడం
మార్చుThe optional parameters pre1, pre2, ...pre12 and custom1, custom2, ...custom12 allow up to 24 other section headers to be listed before or after the "ABCDEF" list:
{{TeluguTOC |name=no |center=yes |top=yes |custom1=New section |custom2=Additional section |seealso=yes|notes=yes}}
{{TeluguTOC |name=no |center=yes |top=yes |custom1=New section|custom1name=Custom section name |custom2=Outside page|custom2link=Main Page |seealso=yes|notes=yes}}
pre1 and custom1 లను వాడి, శీర్షికలను "అఆఇఈ" లకు ముందు గానీ, వాటి తరువాత గానీ చేర్చవచ్చు:
{{TeluguTOC |center=yes |top=yes |pre1=జాబితా పరిధి |pre2=వాడిన పొట్టిపదాలు |prebreak=yes |custom1=జనరంజక అంశాలు|custom2=మినహాయించిన అంశాలు|notes=yes|seealso=yes}}
"short1"
మార్చు{{TeluguTOC |side=yes |center=yes |nobreak=yes |refs=yes}}
is a common configuration whose parameters may be replaced by the shortcut
{{TeluguTOC |short1}}
i.e. by making |short1
the very first parameter.
Examples
మార్చు{{TeluguTOC |top=yes}}
{{TeluguTOC |side=yes |sym=yes|num=yes |custom1=Other |seealso=yes |refs=yes}}
{{TeluguTOC |name=Directory |top=no |refs=yes|notes=yes|extlinks=yes}}
{{TeluguTOC |side=yes|right=yes |name=no |symnum=yes |seealso=yes}}
{{TeluguTOC |short1 |sym=yes|num=yes|seealso=yes|notesfirst=yes|further=yes|extlinks=yes}}
Limitations
మార్చుUnfortunately, it is not possible to center the contents due to the lack of supporting CSS in MediaWiki:Common.css.
ఇవి కూడా చూడండి
మార్చు- {{Compact ToC}}
- సహాయం:చమత్కార పదాలు#విషయసూచిక వద్ద కిందివాటి గురించి మరింత తెలుసుకోవచ్చు
- __NOTOC__
- __TOC__