Add ford project file and GitHub Action to build and deploy documentation

[rouson]

% git checkout ford
% ford ford.md                                
Preprocessing /Users/rouson/Repositories/formal/src/formal/vector_1D_s.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/vector_1D_s.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/vector_1D_s.F90
/Users/rouson/Repositories/formal/src/formal/vector_1D_s.F90:5:2:

    5 | 
      |  1                         
Fatal Error: julienne-assert-macros.h: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/src/formal/gradient_1D_s.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/gradient_1D_s.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/gradient_1D_s.F90
/Users/rouson/Repositories/formal/src/formal/gradient_1D_s.F90:5:2:

    5 | 
      |  1                         
Fatal Error: julienne-assert-macros.h: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/src/formal/gradient_operator_1D_s.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/gradient_operator_1D_s.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/gradient_operator_1D_s.F90
/Users/rouson/Repositories/formal/src/formal/gradient_operator_1D_s.F90:5:2:

    5 | #include "formal-language-support.F90"
      |  1~~~~~~~~~~~~~~~~~~~~~~~~~
Fatal Error: julienne-assert-macros.h: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/src/formal/weighted_product_1D_s.F90
Preprocessing /Users/rouson/Repositories/formal/src/formal/tensors_1D_m.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/tensors_1D_m.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/tensors_1D_m.F90
/Users/rouson/Repositories/formal/src/formal/tensors_1D_m.F90:5:2:

    5 | 
      |  1                            
Fatal Error: formal-language-support.F90: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/example/div-grad-laplacian-1D.F90
Preprocessing /Users/rouson/Repositories/formal/src/formal/divergence_1D_s.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/divergence_1D_s.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/divergence_1D_s.F90
/Users/rouson/Repositories/formal/src/formal/divergence_1D_s.F90:5:2:

    5 | 
      |  1                         
Fatal Error: julienne-assert-macros.h: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/src/formal/scalar_1D_s.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/scalar_1D_s.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/scalar_1D_s.F90
/Users/rouson/Repositories/formal/src/formal/scalar_1D_s.F90:5:2:

    5 | 
      |  1                         
Fatal Error: julienne-assert-macros.h: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/example/print-assembled-1D-operators.F90
Preprocessing /Users/rouson/Repositories/formal/src/formal/scalar_x_divergence_1D_s.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/scalar_x_divergence_1D_s.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/scalar_x_divergence_1D_s.F90
/Users/rouson/Repositories/formal/src/formal/scalar_x_divergence_1D_s.F90:5:2:

    5 | 
      |  1                         
Fatal Error: julienne-assert-macros.h: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/src/formal/mimetic_matrix_1D_s.F90
Preprocessing /Users/rouson/Repositories/formal/example/extended-gauss-divergence.F90
Preprocessing /Users/rouson/Repositories/formal/src/formal/mimetic_operators_1D_m.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/mimetic_operators_1D_m.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/mimetic_operators_1D_m.F90
/Users/rouson/Repositories/formal/src/formal/mimetic_operators_1D_m.F90:5:2:

    5 | 
      |  1                            
Fatal Error: formal-language-support.F90: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/src/formal/divergence_operator_1D_s.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/divergence_operator_1D_s.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/divergence_operator_1D_s.F90
/Users/rouson/Repositories/formal/src/formal/divergence_operator_1D_s.F90:5:2:

    5 | #include "julienne-assert-macros.h"
      |  1~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Fatal Error: formal-language-support.F90: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
Preprocessing /Users/rouson/Repositories/formal/src/formal/vector_dot_gradient_1D_s.F90
Warning: error when preprocessing /Users/rouson/Repositories/formal/src/formal/vector_dot_gradient_1D_s.F90:
gfortran -E -DFORD /Users/rouson/Repositories/formal/src/formal/vector_dot_gradient_1D_s.F90
/Users/rouson/Repositories/formal/src/formal/vector_dot_gradient_1D_s.F90:5:2:

    5 | 
      |  1                         
Fatal Error: julienne-assert-macros.h: No such file or directory
compilation terminated.

Reverting to unpreprocessed file
  Parsing files         ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 18/18 0:00:00 0:00:00 src/formal/vector_dot_gradient_1D_s.F90
  Correlating information from different parts of your project...
  ...done in 0.003s
  Processing comments   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 502/502 0:00:00 0:00:00 volume_integrate_vector_dot_grad_scalar_1D
  Creating HTML documentation... done in 0.002s
  Generating graphs     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 100% 141/141 0:00:00 0:00:25 weighted_product_s
Error rendering page '/Users/rouson/Repositories/formal/doc/html/type/divergence_1d_t.html'
⠋ Creating search index ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━   1%   1/143 -:--:-- 0:00:00 type/divergence_1d_t.html
Traceback (most recent call last):
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/output.py", line 359, in html
    return self.render(self.data, self.proj, self.obj)
           ~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/output.py", line 489, in render
    return self.template.render(
           ~~~~~~~~~~~~~~~~~~~~^
        data, project=project, **{self.payload_key: object}
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
    )
    ^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/jinja2/environment.py", line 1295, in render
    self.environment.handle_exception()
    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/jinja2/environment.py", line 942, in handle_exception
    raise rewrite_traceback_stack(source=source)
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/templates/type_page.html", line 3, in top-level template code
    {% extends "base.html" %}
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/templates/base.html", line 144, in top-level template code
    {% block body %}
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/templates/type_page.html", line 96, in block 'body'
    {{ macros.bound_info(bp) }}
    ^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/jinja2/runtime.py", line 784, in _invoke
    rv = self._func(*arguments)
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/templates/macros.html", line 389, in template
    {{ binding_summary(bind) }}
    ^^^^^^^^^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/jinja2/runtime.py", line 784, in _invoke
    rv = self._func(*arguments)
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/templates/macros.html", line 302, in template
    {{ proc_line(proc, proto=proto) }}
    ^^^^^^^^^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/jinja2/runtime.py", line 784, in _invoke
    rv = self._func(*arguments)
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/templates/macros.html", line 473, in template
    {{ deprecated(proc) }}
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/jinja2/runtime.py", line 784, in _invoke
    rv = self._func(*arguments)
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/templates/macros.html", line 173, in template
    {%- if entity | meta('deprecated') -%}
    ^^^^^^^^^^^^^^^^^^^^^
jinja2.exceptions.UndefinedError: Unknown entity 'divergence_1D_weights': This likely means an error in parsing, please check that this file compiles with a Fortran compiler

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/opt/homebrew/bin/ford", line 8, in <module>
    sys.exit(run())
             ~~~^^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/__init__.py", line 503, in run
    main(proj_data, proj_docs)
    ~~~~^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/__init__.py", line 487, in main
    docs = ford.output.Documentation(proj_data, proj_docs, project, page_tree)
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/output.py", line 256, in __init__
    self.tipue.create_node(page.html, page.loc, page.meta)
                           ^^^^^^^^^
  File "/opt/homebrew/Cellar/ford/7.0.11/libexec/lib/python3.13/site-packages/ford/output.py", line 361, in html
    raise RuntimeError(
    ...<3 lines>...
    )
RuntimeError: Error rendering 'divergence_1d_t.html':
  File "tensors_1D_m.F90": type "divergence_1D_t"
    Unknown entity 'divergence_1D_weights': This likely means an error in parsing, please check that this file compiles with a Fortran compiler

[ktras]

@rouson I have added a commit to the ford branch to get rid of the parsing warnings, but the same error occurs at the end when creating the search index. I think the following part of the error message is the key to what is going wrong, but I can't see any problems with the source code regarding divergence_1D_weights that is causing ford a problem.

RuntimeError: Error rendering 'divergence_1d_t.html':
  File "tensors_1D_m.F90": type "divergence_1D_t"
    Unknown entity 'divergence_1D_weights': This likely means an error in parsing, please check that this file compiles with a Fortran compiler

[rouson]

@ktras please take try ford on the latest version of Formal's main branch and submit a bug report on ford when you have a moment.

[rouson]

@ktras I have isolated and reported this as a ford issue and should be able to push a workaround shortly.

[rouson]

As reported in a comment on the above ford issue, a workaround proved illusive. Fixing this issue probably requires fixing ford.