MACROS
CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS
Info about macros¶
Macros Plugin Environment¶
General List¶
All available variables and filters within the macros plugin:
Variable | Type | Content |
---|---|---|
extra | dict | analytics [dict] |
config | MkDocsConfig | {'config_file_path': '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo/mkdocs.yml', 'site_name': 'NeSI Support Documentation', 'nav': None, 'pages': None, 'exclude_docs': None, 'draft_docs': None, 'not_in_nav': None, 'site_url': 'https://docs.nesi.org.nz/', 'site_description': 'NeSI Support Documentation', 'site_author': None, 'theme': Theme(name='material', dirs=['/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo/overrides', '/home/runner/.local/lib/python3.10/site-packages/material/templates', '/home/runner/.local/lib/python3.10/site-packages/mkdocs/templates'], static_templates={'404.html', 'sitemap.xml'}, name='material', locale=Locale('en'), language='en', direction=None, features=['navigation.indexes', 'navigation.instant', 'navigation.instant.prefetch', 'navigation.top', 'navigation.tracking', 'navigation.path', 'content.code.copy', 'content.action.edit', 'header.site_name_homepage'], font={'text': 'Roboto', 'code': 'Roboto Mono'}, icon=None, favicon='assets/icons/favicon_nesi.ico', logo='assets/icons/logo_nesi.svg', palette=[{'primary': 'custom', 'scheme': 'default', 'toggle': {'icon': 'material/lightbulb', 'name': 'Switch to dark mode'}}, {'primary': 'custom', 'scheme': 'slate', 'toggle': {'icon': 'material/lightbulb-outline', 'name': 'Switch to light mode'}}]), 'docs_dir': '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo/docs', 'site_dir': '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/public/nesi/support-docs/ndjones-patch-2', 'copyright': None, 'google_analytics': None, 'dev_addr': _IpAddressValue(host='127.0.0.1', port=8000), 'use_directory_urls': True, 'repo_url': 'https://github.com/nesi/support-docs', 'repo_name': 'GitHub', 'edit_uri_template': None, 'edit_uri': 'edit/main/docs/', 'extra_css': ['assets/stylesheets/neoteroi-mkdocs.css', 'assets/stylesheets/footer.css', 'assets/stylesheets/custom_admonations.css', 'assets/stylesheets/theme.css'], 'extra_javascript': ['assets/javascripts/general.js', 'https://status.nesi.org.nz/embed/script.js', 'js/open_in_new_tab.js'], 'extra_templates': [], 'markdown_extensions': ['toc', 'tables', 'fenced_code', 'admonition', 'pymdownx.details', 'pymdownx.superfences', 'pymdownx.highlight', 'pymdownx.inlinehilite', 'pymdownx.tabbed', 'pymdownx.snippets', 'attr_list', 'abbr', 'neoteroi.cards', 'neoteroi.timeline', 'footnotes', 'def_list'], 'mdx_configs': {'toc': {'baselevel': 1, 'permalink': True, 'toc_depth': 3, 'title': 'On this page'}, 'pymdownx.tabbed': {'alternate_style': True}}, 'strict': False, 'remote_branch': 'gh-pages', 'remote_name': 'origin', 'extra': {'analytics': {'provider': 'google', 'property': 'G-TVQR4R1F40'}}, 'plugins': {'material/search': |
environment | dict | system = 'Linux', system_version = '6.5.0-1025-azure', python_version = '3.10.12', mkdocs_version = '1.6.0', macros_plugin_version = '1.0.5', jinja2_version = '3.1.3' |
plugin | LegacyConfig | {'module_name': 'macro_hooks', 'modules': [], 'render_by_default': True, 'include_dir': 'overrides', 'include_yaml': [], 'j2_block_start_string': '', 'j2_block_end_string': '', 'j2_variable_start_string': '', 'j2_variable_end_string': '', 'on_undefined': 'keep', 'on_error_fail': True, 'verbose': False} |
git | dict | status = True, date [datetime], short_commit = '441009ea', commit = '441009ea4ae05a61c1ad401ba5e49072e577ba25', tag = '', short_tag = '', author = 'Nick Jones', author_email = 'n.jones@auckland.ac.nz', committer = 'GitHub', committer_email = 'noreply@github.com', date_ISO = 'Fri Oct 25 10:15:46 2024 +1300', message = 'Update how_to_guide.md\n\nformatting updates and tags\n\nSigned-off-by: Nick Jones |
analytics | dict | provider = 'google', property = 'G-TVQR4R1F40' |
applications | dict | ABAQUS [dict], ABRicate [dict], abritamr [dict], Abseil [dict], ABySS [dict], ACTC [dict], AdapterRemoval [dict], AdaptiveCpp [dict], Advisor [dict], AGAT [dict], AGE [dict], AlphaFold [dict], AlphaFold2DB [dict], AlwaysIntelMKL [dict], AMOS [dict], AMRFinderPlus [dict], Anaconda3 [dict], angsd [dict], ANIcalculator [dict], ANNOVAR [dict], ANSYS [dict], ant [dict], antiSMASH [dict], ANTLR [dict], ANTs [dict], any2fasta [dict], AOCC [dict], AOCL-BLIS [dict], AOCL-FFTW [dict], AOCL-ScaLAPACK [dict], Apptainer [dict], APR [dict], APR-util [dict], argtable [dict], aria2 [dict], ARIBA [dict], Armadillo [dict], arpack-ng [dict], Arrow [dict], ASAGI [dict], Aspera-CLI [dict], at-spi2-atk [dict], at-spi2-core [dict], ATK [dict], attr [dict], AUGUSTUS [dict], Autoconf-archive [dict], AutoDock-GPU [dict], AutoDock_Vina [dict], azul-zulu [dict], BamTools [dict], bamUtil [dict], Bandage [dict], barrnap [dict], Basilisk [dict], BayesAss [dict], BayeScan [dict], BayPass [dict], Bazel [dict], BBMap [dict], BCFtools [dict], BCL-Convert [dict], bcl2fastq2 [dict], Beagle [dict], beagle-lib [dict], BEAST [dict], BEDOPS [dict], BEDTools [dict], BEEF [dict], best [dict], BGC-Bayesian-genomic-clines [dict], Bifrost [dict], BiG-SCAPE [dict], binutils [dict], Bio-DB-BigFile [dict], Bio-DB-HTS [dict], bioawk [dict], BioPP [dict], Bismark [dict], Bison [dict], BLAST [dict], BLASTDB [dict], BLAT [dict], BlenderPy [dict], BLIS [dict], BOLT-LMM [dict], Boost [dict], Bowtie [dict], Bowtie2 [dict], Bpipe [dict], Bracken [dict], BRAKER [dict], BreakDancer [dict], BreakSeq2 [dict], breseq [dict], bsddb3 [dict], BUSCO [dict], BWA [dict], bzip2 [dict], c-ares [dict], cairo [dict], Canu [dict], CapnProto [dict], Catch2 [dict], CCL [dict], CD-HIT [dict], cdbfasta [dict], CDO [dict], CellRanger [dict], Centrifuge [dict], Cereal [dict], CFITSIO [dict], CGAL [dict], chainforge [dict], CheckM [dict], CheckM2 [dict], CheckV [dict], chewBBACA [dict], chopper [dict], Circlator [dict], Circos [dict], Clair3 [dict], Clang [dict], Clustal-Omega [dict], ClustalW2 [dict], CMake [dict], CNVnator [dict], CNVpytor [dict], code-server [dict], compleasm [dict], COMSOL [dict], CONCOCT [dict], Corset [dict], CoverM [dict], CP2K [dict], CPMD [dict], CppUnit [dict], CRAMINO [dict], cromwell [dict], ctags [dict], ctffind [dict], CTPL [dict], CubeLib [dict], CubeWriter [dict], CUDA [dict], cuDNN [dict], Cufflinks [dict], CUnit [dict], cURL [dict], cutadapt [dict], cuteSV [dict], cwltool [dict], Cytoscape [dict], cyvcf2 [dict], D-Genies [dict], dadi [dict], DaliLite [dict], dammit [dict], DAS_Tool [dict], datasets [dict], DB [dict], DBus [dict], DeconSeq [dict], DeepLabCut [dict], DeePMD-kit [dict], deepTools [dict], Delft3D [dict], Delft3D_FM [dict], Delly [dict], devtools [dict], DFT-D4 [dict], DIAMOND [dict], DISCOVARdenovo [dict], Dorado [dict], double-conversion [dict], Doxygen [dict], DRAM [dict], drep [dict], Dsuite [dict], dtcmp [dict], duphold [dict], duplex-tools [dict], easi [dict], EasyBuild [dict], ecCodes [dict], ectyper [dict], edlib [dict], eDNA [dict], EDTA [dict], eggnog-mapper [dict], Eigen [dict], EIGENSOFT [dict], ELPA [dict], EMAN2 [dict], EMBOSS [dict], Embree [dict], emmtyper [dict], ENMTML [dict], ensmallen [dict], entrez-direct [dict], ESMF [dict], ETE [dict], EukRep-EukCC [dict], ExaBayes [dict], ExaML [dict], exonerate [dict], ExpansionHunter [dict], expat [dict], Extrae [dict], FALCON [dict], FastANI [dict], FastME [dict], fastp [dict], fastq-tools [dict], FastQ_Screen [dict], FastQC [dict], fastStructure [dict], FastTree [dict], FASTX-Toolkit [dict], fcGENE [dict], FCM [dict], FDS [dict], FFmpeg [dict], FFTW [dict], FFTW.MPI [dict], fgbio [dict], FIGARO [dict], File-Rename [dict], Filtlong [dict], FimTyper [dict], fineRADstructure [dict], fineSTRUCTURE [dict], flatbuffers [dict], flex [dict], FlexiBLAS [dict], FLTK [dict], Flye [dict], fmlrc [dict], fmt [dict], fontconfig [dict], forge [dict], foss [dict], FragGeneScan [dict], FreeBayes [dict], FreeSurfer [dict], freetype [dict], FreeXL [dict], FriBidi [dict], FTGL [dict], funcx-endpoint [dict], fxtract [dict], g2clib [dict], g2lib [dict], ga4gh [dict], GATK [dict], Gaussian [dict], GCC [dict], GCCcore [dict], gcloud [dict], GD [dict], GDAL [dict], Gdk-Pixbuf [dict], geany [dict], GEMMA [dict], gemmforge [dict], GeneMark-ES [dict], GenomeThreader [dict], genometools [dict], GenoVi [dict], GEOS [dict], GetOrganelle [dict], gettext [dict], gfastats [dict], gffread [dict], giflib [dict], gimkl [dict], gimpi [dict], git [dict], GLib [dict], GLibmm [dict], GlimmerHMM [dict], GLM [dict], globus-automate-client [dict], globus-compute-endpoint [dict], GLPK [dict], GMAP-GSNAP [dict], GMP [dict], gmsh [dict], gnuplot [dict], Go [dict], GObject-Introspection [dict], GOLD [dict], gompi [dict], google-sparsehash [dict], googletest [dict], GPAW [dict], gperf [dict], Graphviz [dict], GRASS [dict], GRIDSS [dict], grive2 [dict], GROMACS [dict], GSL [dict], gsort [dict], GST-plugins-base [dict], GStreamer [dict], GTDB-Tk [dict], GTK+ [dict], GTS [dict], Gubbins [dict], GUSHR [dict], h5pp [dict], haplocheck [dict], HarfBuzz [dict], HDF [dict], HDF5 [dict], help2man [dict], hifiasm [dict], HISAT2 [dict], HMMER [dict], HMMER2 [dict], hooks [dict], HOPS [dict], HpcGridRunner [dict], HTSeq [dict], HTSlib [dict], Humann [dict], hunspell [dict], hwloc [dict], HybPiper [dict], hypothesis [dict], Hypre [dict], icc [dict], iccifort [dict], ICU [dict], IDBA-UD [dict], ifort [dict], IGV [dict], iimpi [dict], ImageMagick [dict], imkl [dict], imkl-FFTW [dict], impalajit [dict], impi [dict], IMPUTE [dict], Infernal [dict], info [dict], Inspector [dict], intel [dict], intel-compilers [dict], InterProScan [dict], iofbf [dict], iompi [dict], ipyrad [dict], IQ-TREE [dict], IQmol [dict], IRkernel [dict], ISA-L [dict], ispc [dict], JAGS [dict], JasPer [dict], Java [dict], jbigkit [dict], jcvi [dict], Jellyfish [dict], jemalloc [dict], jq [dict], json-c [dict], JsonCpp [dict], Julia [dict], JUnit [dict], JupyterLab [dict], jvarkit [dict], Kaiju [dict], kalign2 [dict], kallisto [dict], KAT [dict], KEALib [dict], Kent_tools [dict], kineto [dict], kma [dict], KMC [dict], KmerGenie [dict], KorfSNAP [dict], Kraken2 [dict], KronaTools [dict], KyotoCabinet [dict], LAME [dict], LAMMPS [dict], LAST [dict], LASTZ [dict], LDC [dict], LEfSe [dict], LegacySystemLibs [dict], libaec [dict], libarchive [dict], libcircle [dict], libdeflate [dict], libdrm [dict], libdwarf [dict], libepoxy [dict], libevent [dict], libffi [dict], libFLAME [dict], libgcrypt [dict], libgd [dict], libgeotiff [dict], libgit2 [dict], libGLU [dict], libglvnd [dict], libgpg-error [dict], libgpuarray [dict], libgtextutils [dict], libiconv [dict], Libint [dict], libjpeg-turbo [dict], libKML [dict], libpciaccess [dict], libpmi [dict], libpng [dict], libreadline [dict], libsigc++ [dict], libspatialite [dict], libStatGen [dict], LibTIFF [dict], libtool [dict], libunistring [dict], libunwind [dict], libvdwxc [dict], libxc [dict], libxml++ [dict], libxml2 [dict], libxslt [dict], libxsmm [dict], libzstd [dict], Liftoff [dict], lighttpd [dict], likwid [dict], LINKS [dict], LittleCMS [dict], LLVM [dict], LMDB [dict], logs [dict], LongStitch [dict], lp_solve [dict], LSD2 [dict], LTR_retriever [dict], LUMPY [dict], lwgrp [dict], lz4 [dict], LZO [dict], M4 [dict], maf_stream [dict], MAFFT [dict], MAGMA [dict], magma [dict], Magma [dict], MAKER [dict], Mamba [dict], manta [dict], mapDamage [dict], MarkerMiner [dict], Mash [dict], MashMap [dict], Mashtree [dict], MaSuRCA [dict], MATIO [dict], MATLAB [dict], Maven [dict], MaxBin [dict], MCL [dict], MCR [dict], medaka [dict], MEGAHIT [dict], megalodon [dict], meRanTK [dict], Merqury [dict], Mesa [dict], Meson [dict], MetaBAT [dict], METABOLIC [dict], MetaEuk [dict], MetaGeneAnnotator [dict], MetaPhlAn [dict], MetaPhlAn2 [dict], Metashape [dict], MetaSV [dict], metaWRAP [dict], Metaxa2 [dict], METIS [dict], mimalloc [dict], MiMiC [dict], MiMiC-CommLib [dict], miniasm [dict], miniBUSCO [dict], Miniconda3 [dict], Miniforge3 [dict], Minimac3 [dict], Minimac4 [dict], minimap2 [dict], miniprot [dict], miRDeep2 [dict], MitoZ [dict], mlpack [dict], MMseqs2 [dict], modbam2bed [dict], ModDotPlot [dict], ModelTest-NG [dict], MODFLOW [dict], modkit [dict], Molcas [dict], Molpro [dict], Mono [dict], Monocle3 [dict], mosdepth [dict], Mothur [dict], mpcci [dict], MPFR [dict], mpifileutils [dict], MrBayes [dict], MSMC [dict], MultiQC [dict], MUMmer [dict], MUMPS [dict], muParser [dict], MUSCLE [dict], MUST [dict], NAMD [dict], nano [dict], NanoComp [dict], nanofilt [dict], nanoget [dict], NanoLyse [dict], nanomath [dict], NanoPlot [dict], nanopolish [dict], nanoQC [dict], NanoStat [dict], NASM [dict], ncbi-vdb [dict], NCCL [dict], NCL [dict], NCO [dict], ncurses [dict], ncview [dict], ne [dict], nearline [dict], NECAT [dict], netCDF [dict], netCDF-C++ [dict], netCDF-C++4 [dict], netCDF-Fortran [dict], NewHybrids [dict], Newton-X [dict], Nextflow [dict], NextGenMap [dict], NGS [dict], Nim [dict], Ninja [dict], NLopt [dict], nodejs [dict], NONMEM [dict], nseg [dict], Nsight-Compute [dict], Nsight-Systems [dict], NSPR [dict], NSS [dict], nsync [dict], nullarbor [dict], numactl [dict], NVHPC [dict], NWChem [dict], OBITools [dict], objects [dict], OMA [dict], ont-guppy-gpu [dict], OPARI2 [dict], OpenBabel [dict], OpenBLAS [dict], OpenCV [dict], OpenFAST [dict], OpenFOAM [dict], OpenJPEG [dict], OpenMPI [dict], OpenSees [dict], OpenSeesPy [dict], OpenSlide [dict], OpenSSL [dict], ORCA [dict], OrfM [dict], OrthoFiller [dict], OrthoFinder [dict], OrthoMCL [dict], OSPRay [dict], OSU-Micro-Benchmarks [dict], OTF2 [dict], padloc [dict], pairtools [dict], PALEOMIX [dict], PAML [dict], panaroo [dict], pandoc [dict], Pango [dict], PAPI [dict], Parallel [dict], parallel-fastq-dump [dict], ParallelIO [dict], parasail [dict], ParaView [dict], ParMETIS [dict], patchelf [dict], pauvre [dict], PCRE [dict], PCRE2 [dict], PDT [dict], PEAR [dict], Peregrine [dict], Perl [dict], PEST++ [dict], PETSc [dict], pggb [dict], pgge [dict], PHASIUS [dict], phonopy [dict], PhyloPhlAn [dict], PhyML [dict], phyx [dict], picard [dict], pigz [dict], Pilon [dict], pixman [dict], PLINK [dict], PLUMED [dict], PnetCDF [dict], pod5 [dict], Porechop [dict], Porechop_ABI [dict], PostgreSQL [dict], pplacer [dict], PRANK [dict], preseq [dict], prodigal [dict], Prodigal [dict], prodigal-gv [dict], PROJ [dict], prokka [dict], Proteinortho [dict], ProtHint [dict], protobuf [dict], psmc [dict], PSpaMM [dict], pstoedit [dict], pullseq [dict], PUMI [dict], purge_dups [dict], purge_haplotigs [dict], pv [dict], pyani [dict], pycoQC [dict], pymol-open-source [dict], PyOpenGL [dict], PyQt [dict], pyspoa [dict], Python [dict], Python-Geo [dict], PyTorch [dict], qcat [dict], QChem [dict], QIIME2 [dict], Qt5 [dict], QuantumESPRESSO [dict], QUAST [dict], QuickTree [dict], R [dict], R-bundle-Bioconductor [dict], R-Geo [dict], Racon [dict], Ragout [dict], randfold [dict], RANGS-GSHHS [dict], RapidNJ [dict], rasusa [dict], Ratatosk [dict], Raven [dict], RAxML [dict], RAxML-NG [dict], razers3 [dict], rclone [dict], Rcorrector [dict], rDock [dict], RDP-Classifier [dict], RE2 [dict], re2c [dict], RECON [dict], refs [dict], Relion [dict], RepeatMasker [dict], RepeatModeler [dict], RepeatScout [dict], REViewer [dict], RFdiffusion [dict], RFPlasmid [dict], Riskscape [dict], rkcommon [dict], RMBlast [dict], RNAmmer [dict], rnaQUAST [dict], Roary [dict], ROCm [dict], ROOT [dict], Rosetta [dict], RSEM [dict], RSGISLib [dict], RStudio-Server [dict], Ruby [dict], Rust [dict], rust-fmlrc [dict], SAGE [dict], Salmon [dict], Sambamba [dict], samblaster [dict], samclip [dict], SAMtools [dict], SAS [dict], savvy [dict], sbt [dict], sc-RNA [dict], ScaLAPACK [dict], SCons [dict], SCOTCH [dict], screen_assembly [dict], SDL2 [dict], SeisSol [dict], SEPP [dict], SeqAn [dict], SeqAn3 [dict], SeqKit [dict], seqmagick [dict], seqtk [dict], SHAPEIT4 [dict], shrinkwrap [dict], SiBELia [dict], Siesta [dict], SignalP [dict], simuG [dict], Singularity [dict], SIONlib [dict], SIP [dict], sismonr [dict], skani [dict], SKESA [dict], slow5tools [dict], smafa [dict], smoove [dict], SMRT-Link [dict], snakemake [dict], snaphu [dict], snappy [dict], Sniffles [dict], snp-sites [dict], snpEff [dict], SNVoter-NanoMethPhase [dict], SOCI [dict], somalier [dict], SortMeRNA [dict], SourceTracker [dict], Spack [dict], SPAdes [dict], spaln [dict], Spark [dict], spdlog [dict], SpectrA [dict], SPIDER [dict], splat [dict], spoa [dict], SQLite [dict], SqueezeMeta [dict], sratoolkit [dict], srun-wrapper [dict], SSAHA2 [dict], Stacks [dict], STAR [dict], STAR-Fusion [dict], StringTie [dict], Structure [dict], sublime [dict], Subread [dict], Subversion [dict], SuiteSparse [dict], SUNDIALS [dict], SuperLU [dict], Supernova [dict], SURVIVOR [dict], swarm [dict], SWIG [dict], swissknife [dict], Szip [dict], tabix [dict], tabixpp [dict], tbb [dict], tbl2asn [dict], Tcl [dict], TensorFlow [dict], TensorRT [dict], TEtranscripts [dict], Theano [dict], Tk [dict], TMHMM [dict], tmux [dict], TOGA [dict], TransDecoder [dict], TreeMix [dict], trf [dict], trimAl [dict], TrimGalore [dict], Trimmomatic [dict], Trinity [dict], Trinotate [dict], tRNAscan-SE [dict], Trycycler [dict], TSEBRA [dict], TuiView [dict], TURBOMOLE [dict], TurboVNC [dict], TWL-NINJA [dict], UCC [dict], UCX [dict], UDUNITS [dict], Unicycler [dict], unimap [dict], unrar [dict], USEARCH [dict], util-linux [dict], Valgrind [dict], VarScan [dict], VASP [dict], VCF-kit [dict], vcflib [dict], VCFtools [dict], Velvet [dict], VelvetOptimiser [dict], VEP [dict], verkko [dict], vg [dict], VIBRANT [dict], ViennaRNA [dict], Vim [dict], VirHostMatcher [dict], VirSorter [dict], VirtualGL [dict], VMD [dict], VSEARCH [dict], VTK [dict], VTune [dict], WAAFLE [dict], wgsim [dict], WhatsHap [dict], wheel [dict], Winnowmap [dict], Wise2 [dict], wtdbg [dict], wxWidgets [dict], x264 [dict], x265 [dict], Xerces-C++ [dict], XHMM [dict], xkbcommon [dict], XMDS2 [dict], XSD [dict], xtb [dict], XZ [dict], yacrd [dict], yajl [dict], yak [dict], yaml-cpp [dict], Yasm [dict], YAXT [dict], Z3 [dict], ZeroMQ [dict], Zip [dict], zlib [dict], zstd [dict] |
macros | SuperDict | context [function], macros_info [function], now [function], fix_url [function] |
filters | dict | pretty [function] |
filters_builtin | dict | abs [builtin_function_or_method], attr [function], batch [function], capitalize [function], center [function], count [builtin_function_or_method], d [function], default [function], dictsort [function], e [builtin_function_or_method], escape [builtin_function_or_method], filesizeformat [function], first [function], float [function], forceescape [function], format [function], groupby [function], indent [function], int [function], join [function], last [function], length [builtin_function_or_method], list [function], lower [function], items [function], map [function], min [function], max [function], pprint [function], random [function], reject [function], rejectattr [function], replace [function], reverse [function], round [function], safe [function], select [function], selectattr [function], slice [function], sort [function], string [builtin_function_or_method], striptags [function], sum [function], title [function], trim [function], truncate [function], unique [function], upper [function], urlencode [function], urlize [function], wordcount [function], wordwrap [function], xmlattr [function], tojson [function] |
navigation | Navigation | |
files | Files | |
page | Page | Page(title='MACROS', url='/MACROS/') |
Config Information¶
Standard MkDocs configuration information. Do not try to modify.
e.g. {{ config.docs_dir }}
See also the MkDocs documentation on the config object.
Variable | Type | Content |
---|---|---|
config_file_path | str | '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo/mkdocs.yml' |
site_name | str | 'NeSI Support Documentation' |
nav | NoneType | None |
pages | NoneType | None |
exclude_docs | NoneType | None |
draft_docs | NoneType | None |
not_in_nav | NoneType | None |
site_url | str | 'https://docs.nesi.org.nz/' |
site_description | str | 'NeSI Support Documentation' |
site_author | NoneType | None |
theme | Theme | Theme(name='material', dirs=['/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo/overrides', '/home/runner/.local/lib/python3.10/site-packages/material/templates', '/home/runner/.local/lib/python3.10/site-packages/mkdocs/templates'], static_templates={'404.html', 'sitemap.xml'}, name='material', locale=Locale('en'), language='en', direction=None, features=['navigation.indexes', 'navigation.instant', 'navigation.instant.prefetch', 'navigation.top', 'navigation.tracking', 'navigation.path', 'content.code.copy', 'content.action.edit', 'header.site_name_homepage'], font={'text': 'Roboto', 'code': 'Roboto Mono'}, icon=None, favicon='assets/icons/favicon_nesi.ico', logo='assets/icons/logo_nesi.svg', palette=[{'primary': 'custom', 'scheme': 'default', 'toggle': {'icon': 'material/lightbulb', 'name': 'Switch to dark mode'}}, {'primary': 'custom', 'scheme': 'slate', 'toggle': {'icon': 'material/lightbulb-outline', 'name': 'Switch to light mode'}}]) |
docs_dir | str | '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo/docs' |
site_dir | str | '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/public/nesi/support-docs/ndjones-patch-2' |
copyright | NoneType | None |
google_analytics | NoneType | None |
dev_addr | _IpAddressValue | _IpAddressValue(host='127.0.0.1', port=8000) |
use_directory_urls | bool | True |
repo_url | str | 'https://github.com/nesi/support-docs' |
repo_name | str | 'GitHub' |
edit_uri_template | NoneType | None |
edit_uri | str | 'edit/main/docs/' |
extra_css | list | ['assets/stylesheets/neoteroi-mkdocs.css', 'assets/stylesheets/footer.css', 'assets/stylesheets/custom_admonations.css', 'assets/stylesheets/theme.css'] |
extra_javascript | list | ['assets/javascripts/general.js', 'https://status.nesi.org.nz/embed/script.js', 'js/open_in_new_tab.js'] |
extra_templates | list | [] |
markdown_extensions | list | ['toc', 'tables', 'fenced_code', 'admonition', 'pymdownx.details', 'pymdownx.superfences', 'pymdownx.highlight', 'pymdownx.inlinehilite', 'pymdownx.tabbed', 'pymdownx.snippets', 'attr_list', 'abbr', 'neoteroi.cards', 'neoteroi.timeline', 'footnotes', 'def_list'] |
mdx_configs | dict | toc [dict], pymdownx.tabbed [dict] |
strict | bool | False |
remote_branch | str | 'gh-pages' |
remote_name | str | 'origin' |
extra | LegacyConfig | {'analytics': {'provider': 'google', 'property': 'G-TVQR4R1F40'}} |
plugins | PluginCollection | material/search [SearchPlugin], open-in-new-tab [OpenInNewTabPlugin], rss [GitRssPlugin], redirects [RedirectPlugin], awesome-pages [AwesomePagesPlugin], material/tags [TagsPlugin], git-revision-date-localized [GitRevisionDateLocalizedPlugin], macros [MacrosPlugin], mkdocs_hooks.py [module] |
hooks | dict | mkdocs_hooks.py [module] |
watch | list | [] |
validation | Validation | {'nav': {'omitted_files': 20, 'not_found': 30, 'absolute_links': 20}, 'links': {'not_found': 30, 'absolute_links': 20, 'unrecognized_links': 20, 'anchors': 20}} |
Macros¶
These macros have been defined programmatically for this environment (module or pluglets).
Variable | Type | Content |
---|---|---|
context | function | (obj, e) Default mkdocs_macro List the defined variables |
macros_info | function | () Test/debug function: list useful documentation on the mkdocs_macro environment. |
now | function | () Get the current time (returns a datetime object). Used alone, it provides a timestamp. To get the year use |
fix_url | function | (url, r) If url is relative, fix it so that it points to the docs diretory. This is necessary because relative links in markdown must be adapted in html ('img/foo.png' => '../img/img.png'). |
Git Information¶
Information available on the last commit and the git repository containing the documentation project:
e.g. {{ git.message }}
Variable | Type | Content |
---|---|---|
status | bool | True |
date | datetime | datetime.datetime(2024, 10, 25, 10, 15, 46, tzinfo=tzoffset(None, 46800)) |
short_commit | str | '441009ea' |
commit | str | '441009ea4ae05a61c1ad401ba5e49072e577ba25' |
tag | str | '' |
short_tag | str | '' |
author | str | 'Nick Jones' |
author_email | str | 'n.jones@auckland.ac.nz' |
committer | str | 'GitHub' |
committer_email | str | 'noreply@github.com' |
date_ISO | str | 'Fri Oct 25 10:15:46 2024 +1300' |
message | str | 'Update how_to_guide.md\n\nformatting updates and tags\n\nSigned-off-by: Nick Jones |
raw | str | 'commit 441009ea4ae05a61c1ad401ba5e49072e577ba25\nAuthor: Nick Jones |
root_dir | str | '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo' |
Page Attributes¶
Provided by MkDocs. These attributes change for every page (the attributes shown are for this page).
e.g. {{ page.title }}
See also the MkDocs documentation on the page object.
Variable | Type | Content |
---|---|---|
file | File | src_uri = 'MACROS.md', src_dir = '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo/docs', dest_dir = '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/public/nesi/support-docs/ndjones-patch-2', use_directory_urls = True, inclusion [InclusionLevel], name = 'MACROS', dest_uri = 'MACROS/index.html', page [Page], url = 'MACROS/', abs_src_path = '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/repo/docs/MACROS.md', abs_dest_path = '/home/runner/work/mkdocs-demo-deploy/mkdocs-demo-deploy/public/nesi/support-docs/ndjones-patch-2/MACROS/index.html' |
children | NoneType | None |
previous_page | Page | Page(title='GLOSSARY', url='/GLOSSARY/') |
next_page | Page | Page(title=[blank], url='/NEWPAGE/') |
_Page__active | bool | False |
update_date | str | '2024-11-17' |
canonical_url | str | 'https://docs.nesi.org.nz/MACROS/' |
abs_url | str | '/MACROS/' |
edit_url | str | 'https://github.com/nesi/support-docs/edit/main/docs/MACROS.md' |
markdown | str | '**[CLICK TO VIEW THIS PAGE RENDERED IN MKDOCS](https://nesi.github.io/support-docs/MACROS/)**{ .hidden }\n\n## Info about macros\n\n{{ macros_info() }}\n' |
_title_from_render | NoneType | None |
content | NoneType | None |
toc | list | [] |
meta | dict | search [dict], git_revision_date_localized = 'August 17, 2024', git_revision_date_localized_raw_date = 'August 17, 2024', git_revision_date_localized_raw_datetime = 'August 17, 2024 21:41:35', git_revision_date_localized_raw_iso_date = '2024-08-17', git_revision_date_localized_raw_iso_datetime = '2024-08-17 21:41:35', git_revision_date_localized_raw_timeago = '', git_revision_date_localized_raw_custom = '17. August 2024', git_site_revision_date_localized = 'October 24, 2024', git_site_revision_date_localized_raw_date = 'October 24, 2024', git_site_revision_date_localized_raw_datetime = 'October 24, 2024 21:15:46', git_site_revision_date_localized_raw_iso_date = '2024-10-24', git_site_revision_date_localized_raw_iso_datetime = '2024-10-24 21:15:46', git_site_revision_date_localized_raw_timeago = '', git_site_revision_date_localized_raw_custom = '24. October 2024' |
To have all titles of all pages, use:
{% for page in navigation.pages %}
- {{ page.title }}
{% endfor %}
Plugin Filters¶
These filters are provided as a standard by the macros plugin.
Variable | Type | Content |
---|---|---|
pretty | function | (var_list, rows, header, e) Default mkdocs_macro Prettify a dictionary or object (used for environment documentation, or debugging). |
Builtin Jinja2 Filters¶
These filters are provided by Jinja2 as a standard.
See also the Jinja2 documentation on builtin filters).
Variable | Type | Content |
---|---|---|
abs | builtin_function_or_method | Return the absolute value of the argument. |
attr | function | (environment, obj, name, value) Get an attribute of an object. |
batch | function | (value, linecount, fill_with, tmp, item) A filter that batches items. It works pretty much like |
capitalize | function | (s) Capitalize a value. The first character will be uppercase, all others lowercase. |
center | function | (value, width) Centers the value in a field of a given width. |
count | builtin_function_or_method | Return the number of items in a container. |
d | function | (value, default_value, boolean) If the value is undefined it will return the passed default value, otherwise the value of the variable. |
default | function | (value, default_value, boolean) If the value is undefined it will return the passed default value, otherwise the value of the variable. |
dictsort | function | (value, case_sensitive, by, reverse, sort_func) Sort a dict and yield (key, value) pairs. Python dicts may not be in the order you want to display them in, so sort them first. |
e | builtin_function_or_method | Replace the characters |
escape | builtin_function_or_method | Replace the characters |
filesizeformat | function | (value, binary, bytes, base, prefixes, i, prefix, unit) Format the value like a 'human-readable' file size (i.e. 13 kB, 4.1 MB, 102 Bytes, etc). Per default decimal prefixes are used (Mega, Giga, etc.), if the second parameter is set to |
first | function | (args, kwargs, b) Return the first item of a sequence. |
float | function | (value, default) Convert the value into a floating point number. If the conversion doesn't work it will return |
forceescape | function | (value) Enforce HTML escaping. This will probably double escape variables. |
format | function | (value, args, kwargs) Apply the given values to a |
groupby | function | (args, kwargs, b) Group a sequence of objects by an attribute using Python's :func: |
indent | function | (s, width, first, blank, newline, rv, lines) Return a copy of the string with each line indented by 4 spaces. The first line and blank lines are not indented by default. |
int | function | (value, default, base) Convert the value into an integer. If the conversion doesn't work it will return |
join | function | (args, kwargs, b) Return a string which is the concatenation of the strings in the sequence. The separator between elements is an empty string per default, you can define it with the optional parameter. |
last | function | (environment, seq) Return the last item of a sequence. |
length | builtin_function_or_method | Return the number of items in a container. |
list | function | (args, kwargs, b) Convert the value into a list. If it was a string the returned list will be a list of characters. |
lower | function | (s) Convert a value to lowercase. |
items | function | (value) Return an iterator over the |
map | function | (args, kwargs, b) Applies a filter on a sequence of objects or looks up an attribute. This is useful when dealing with lists of objects but you are really only interested in a certain value of it. |
min | function | (environment, value, case_sensitive, attribute) Return the smallest item from the sequence. |
max | function | (environment, value, case_sensitive, attribute) Return the largest item from the sequence. |
pprint | function | (value) Pretty print a variable. Useful for debugging. |
random | function | (context, seq) Return a random item from the sequence. |
reject | function | (args, kwargs, b) Filters a sequence of objects by applying a test to each object, and rejecting the objects with the test succeeding. |
rejectattr | function | (args, kwargs, b) Filters a sequence of objects by applying a test to the specified attribute of each object, and rejecting the objects with the test succeeding. |
replace | function | (eval_ctx, s, old, new, count) Return a copy of the value with all occurrences of a substring replaced with a new one. The first argument is the substring that should be replaced, the second is the replacement string. If the optional third argument |
reverse | function | (value, rv, e) Reverse the object or return an iterator that iterates over it the other way round. |
round | function | (value, precision, method, func) Round the number to a given precision. The first parameter specifies the precision (default is |
safe | function | (value) Mark the value as safe which means that in an environment with automatic escaping enabled this variable will not be escaped. |
select | function | (args, kwargs, b) Filters a sequence of objects by applying a test to each object, and only selecting the objects with the test succeeding. |
selectattr | function | (args, kwargs, b) Filters a sequence of objects by applying a test to the specified attribute of each object, and only selecting the objects with the test succeeding. |
slice | function | (args, kwargs, b) Slice an iterator and return a list of lists containing those items. Useful if you want to create a div containing three ul tags that represent columns. |
sort | function | (environment, value, reverse, case_sensitive, attribute, key_func) Sort an iterable using Python's :func: |
string | builtin_function_or_method | Convert an object to a string if it isn't already. This preserves a :class: |
striptags | function | (value) Strip SGML/XML tags and replace adjacent whitespace by one space. |
sum | function | (args, kwargs, b) Returns the sum of a sequence of numbers plus the value of parameter 'start' (which defaults to 0). When the sequence is empty it returns start. |
title | function | (s) Return a titlecased version of the value. I.e. words will start with uppercase letters, all remaining characters are lowercase. |
trim | function | (value, chars) Strip leading and trailing characters, by default whitespace. |
truncate | function | (env, s, length, killwords, end, leeway, result) Return a truncated copy of the string. The length is specified with the first parameter which defaults to |
unique | function | (environment, value, case_sensitive, attribute, getter, seen, item, key) Returns a list of unique items from the given iterable. |
upper | function | (s) Convert a value to uppercase. |
urlencode | function | (value, items) Quote data for use in a URL path or query using UTF-8. |
urlize | function | (eval_ctx, value, trim_url_limit, nofollow, target, rel, extra_schemes, policies, rel_parts, scheme, rv) Convert URLs in text into clickable links. |
wordcount | function | (s) Count the words in that string. |
wordwrap | function | (environment, s, width, break_long_words, wrapstring, break_on_hyphens) Wrap a string to the given width. Existing newlines are treated as paragraphs to be wrapped separately. |
xmlattr | function | (eval_ctx, d, autospace, items, key, value, rv) Create an SGML/XML attribute string based on the items in a dict. |
tojson | function | (eval_ctx, value, indent, policies, dumps, kwargs) Serialize an object to a string of JSON, and mark it safe to render in HTML. This filter is only for use in HTML documents. |