Skip to content

Commit 4fcf871

Browse files
committed
Refactor Doxygen configuration and update doc
- Updated GitHub Actions workflow for Doxygen documentation deployment - Moved and renamed Doxyfile to project root - Removed obsolete documentation files from doc/ - Updated README.md to reflect documentation changes
1 parent 8bea645 commit 4fcf871

File tree

8 files changed

+10
-2938
lines changed

8 files changed

+10
-2938
lines changed

.github/workflows/doxygen-gh-pages.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,4 +15,4 @@ jobs:
1515
github_token: ${{ secrets.GITHUB_TOKEN }}
1616
branch: gh-pages
1717
folder: docs
18-
config_file: doc/Doxyfile
18+
config_file: Doxyfile

doc/Doxyfile renamed to Doxyfile

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ PROJECT_BRIEF = "Arduino on Pi boards, the best of both worlds !"
6161
# pixels and the maximum width should not exceed 200 pixels. Doxygen will copy
6262
# the logo to the output directory.
6363

64-
PROJECT_LOGO = ./images/PiduinoLogoSmall.png
64+
PROJECT_LOGO = doc/images/PiduinoLogoSmall.png
6565

6666
# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
6767
# into which the generated documentation will be written. If a relative path is
@@ -815,7 +815,7 @@ FILE_VERSION_FILTER =
815815
# DoxygenLayout.xml, doxygen will parse it automatically even if the LAYOUT_FILE
816816
# tag is left empty.
817817

818-
LAYOUT_FILE = DoxygenLayout.xml
818+
LAYOUT_FILE =
819819

820820
# The CITE_BIB_FILES tag can be used to specify one or more bib files containing
821821
# the reference definitions. This must be a list of .bib files. The .bib
@@ -943,8 +943,7 @@ WARN_LOGFILE =
943943
# spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
944944
# Note: If this tag is empty the current directory is searched.
945945

946-
INPUT = ../README.md \
947-
../include/piduino
946+
INPUT = README.md include/piduino
948947

949948
# This tag can be used to specify the character encoding of the source files
950949
# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -984,8 +983,7 @@ INPUT_FILE_ENCODING =
984983
# provided as doxygen C comment), *.py, *.pyw, *.f90, *.f95, *.f03, *.f08,
985984
# *.f18, *.f, *.for, *.vhd, *.vhdl, *.ucf, *.qsf and *.ice.
986985

987-
FILE_PATTERNS = *.h \
988-
*.md
986+
FILE_PATTERNS = *.h *.md
989987

990988
# The RECURSIVE tag can be used to specify whether or not subdirectories should
991989
# be searched for input files as well.
@@ -1030,7 +1028,7 @@ EXCLUDE_SYMBOLS =
10301028
# that contain example code fragments that are included (see the \include
10311029
# command).
10321030

1033-
EXAMPLE_PATH = ../examples
1031+
EXAMPLE_PATH = examples
10341032

10351033
# If the value of the EXAMPLE_PATH tag contains directories, you can use the
10361034
# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp and
@@ -1050,7 +1048,7 @@ EXAMPLE_RECURSIVE = YES
10501048
# that contain images that are to be included in the documentation (see the
10511049
# \image command).
10521050

1053-
IMAGE_PATH = images
1051+
IMAGE_PATH = doc/images
10541052

10551053
# The INPUT_FILTER tag can be used to specify a program that doxygen should
10561054
# invoke to filter for each input file. Doxygen will invoke the filter program
@@ -1111,7 +1109,7 @@ FILTER_SOURCE_PATTERNS =
11111109
# (index.html). This can be useful if you have a project on for instance GitHub
11121110
# and want to reuse the introduction page also for the doxygen output.
11131111

1114-
USE_MDFILE_AS_MAINPAGE = ../README.md
1112+
USE_MDFILE_AS_MAINPAGE = README.md
11151113

11161114
# The Fortran standard specifies that for fixed formatted Fortran code all
11171115
# characters from position 72 are to be considered as comment. A common
@@ -1360,7 +1358,7 @@ HTML_EXTRA_STYLESHEET =
13601358
# files will be copied as-is; there are no commands or markers available.
13611359
# This tag requires that the tag GENERATE_HTML is set to YES.
13621360

1363-
HTML_EXTRA_FILES = osi.png
1361+
HTML_EXTRA_FILES =
13641362

13651363
# The HTML_COLORSTYLE tag can be used to specify if the generated HTML output
13661364
# should be rendered with a dark or light theme.

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
_Arduino on Pi boards, the best of both worlds !_
44

5-
<img src="https://raw.githubusercontent.com/epsilonrt/piduino/master/doc/images/PiduinoCommunityLogo.png" alt="Piduino Logo" align="right" valign="top">
5+
<img src="https://raw.githubusercontent.com/epsilonrt/piduino/master/doc/images/PiduinoCommunityLogoSmall.png" alt="Piduino Logo" align="right" valign="top">
66

77
[![GitHub release (latest by date including pre-releases)](https://img.shields.io/github/v/release/epsilonrt/piduino?include_prereleases)](https://github.com/epsilonrt/piduino/releases)
88

0 commit comments

Comments
 (0)