Skip to content

Latest commit

 

History

History
51 lines (40 loc) · 2.86 KB

README.md

File metadata and controls

51 lines (40 loc) · 2.86 KB

mfem / web

This repo contains the MFEM website MkDocs sources.

To make changes to the website you will need an install of Python version >= 3.6.9 and < 3.10 with the following libraries:

  • use MkDocs v1.0.4 with Markdown v3.0 and the latest PyYAML and mkdocs-exclude-search:
    • pip install --upgrade --user mkdocs==1.0.4
    • pip install --upgrade --user Markdown==3.0
    • pip install --upgrade --user PyYAML
    • pip install --upgrade --user mkdocs-exclude-search
    • pip install --upgrade --user "jinja2<3.1.0"
  • or in a Python virtual environment
    • python3 -m venv mfem-web-venv
    • . ./mfem-web-venv/bin/activate
    • pip install -r requirements.txt
  • newer versions may not generate correct front page (to see the installed version, use pip show mkdocs)
  • make sure you don't have mkdocs-material installed which may conflict with regular mkdocs
  • clone this repo,
  • edit or add some .md files (you may also need to update the mkdocs.yml config),
  • preview locally with mkdocs serve (Windows users may need to specify a port, such as mkdocs serve --dev-addr 127.0.0.1:4000),
  • publish with mkdocs gh-deploy.

Breadcrumbs:

  • We have several article collections: tag-howto, tag-gettingstarted, tag-fem, tag-mesh each of which has a base page, e.g. howto-index.md for tag-howto.
  • If an article belongs to a collection, a "Back to " link will appear below its TOC.
  • To mark that an article is part of one or several collection, add the tags at the very beginning of the file, see e.g. fem.md.
  • To add a new collection, see the code in template/toc.html.

Checklist for adding examples:

  • Add a one-line summary of the example in features.md
  • Add an image file in img/examples/, e.g. img/examples/ex1.png
  • Add a brief description in examples.md following the description at the top of the C++ file
  • Add a "showElement" line with the appropriate categories for the example in the update function at the end of examples.md

To add a new Application / Finite Elements / Discretization / Solver category:

  • Add an <option> tag at the top of examples.md, e.g. <option id="wave">Wave</option>
  • Use the id in filter expressions of appropriate examples in update, e.g. showElement("ex25", (maxwell || wave) && hcurl && galerkin && (gmres || ams));

Checklist for adding miniapps:

  • Consider adding a one-line summary of the example in features.md (if we want to advertise the miniapp to users)
  • Add an image file in img/examples/, e.g. img/examples/shaper.png
  • Add a brief description in examples.md following the description at the top of the C++ file
  • Add a "showElement" line with the appropriate categories for the miniapp in the update function at the end of examples.md
  • If the miniapp is part of a group, e.g. meshing miniapps, add it also to meshing-miniapps.md