Compare commits

..

16 Commits

Author SHA1 Message Date
735afe9982 Add new item to ROADMAP for version v0.2.0 2022-11-12 14:55:55 +01:00
6b2bc43d79 Allow choosing port number. 2022-11-10 19:58:46 +01:00
1d1406bb2b Remove unnecessary if-statement. 2022-11-10 19:22:24 +01:00
fc50e669a5 Implement concurrent page compilation. 2022-11-10 19:10:41 +01:00
60c6cb3bcd Consolidate compilation and copy code. 2022-11-10 17:45:00 +01:00
a799374399 Remove need for tmp directory. 2022-11-10 17:07:03 +01:00
281a31f5f7 Remove non-redundant compiling from roadmap.
At least for now this seems to be a bit difficult to implement, due to
dependency testing.
2022-11-09 18:40:22 +01:00
74e2c1a3fd Use local variables. 2022-11-08 16:40:13 +01:00
91b8b3b570 Add verbose flag to build. 2022-11-08 16:10:07 +01:00
e5bbf2dc03 Test for too few commands. 2022-11-08 16:02:38 +01:00
48bdc40932 No source dir to be found anymore. 2022-11-08 15:59:22 +01:00
805139d2ca Add example file. 2022-11-08 15:58:20 +01:00
7c1aec3497 Consolodate project directories into variables. 2022-11-08 15:52:12 +01:00
bfcd194a09 Copy other files into output. 2022-11-08 15:12:29 +01:00
c901bc3b0c Ignore configuration files for PHP variables. 2022-11-07 20:43:19 +01:00
ad5d10979d Add serve command. 2022-11-07 20:26:23 +01:00
13 changed files with 190 additions and 37 deletions

1
.gitignore vendored Normal file
View File

@ -0,0 +1 @@
output/

View File

@ -14,9 +14,15 @@ Synopsis: `isidore <command> [options]`
Commands:
- `new <dir> <name>`: create a new project directory `<dir>` with project name
`<name>`.
- `build`: build the website (default).
- `new [args] <dir>`: create a new project.
- `<dir>`: new project directory.
- `-i`: interactive mode.
- `build [args]`: build the website.
- `-j<n>`: number of jobs to run concurrently. With `0` it compiles all files
at once.
- `-v`: run with verbose output.
- `serve`, `server [args]`: run an HTTP server of the output (default port 8080).
- `-p <port>`: port number to bind server to.
- `clean`: cleans build files.
- `help`: show help information.
- `version`: show Isidore version number.
@ -47,7 +53,7 @@ please take a look at what needs to be done in the [roadmap](/ROADMAP.md), or
check if there are any to-do comments in the code:
```bash
grep -r "TODO" src/
grep "TODO" isidore.sh
```
## License & Copyright

View File

@ -4,7 +4,7 @@
- New project subcommand
- Basic project compilation
- v0.2
- Don't compile already compiled files
- Multi-thread compiling
- Helper functions & variables
- v0.3
- Markdown support

1
example/.isidore-version Normal file
View File

@ -0,0 +1 @@
0.1.0

5
example/config.php Normal file
View File

@ -0,0 +1,5 @@
<?php
$site_name = "New Project";
$site_author = "Nicolás A. Ortega Froysa";
$site_url = "http://example.com/";
?>

View File

@ -0,0 +1,23 @@
<?php
$title = "Blog";
include("templates/header.html.php");
?>
<p>
Welcome to my blog page! Here's a list of my current entries:
</p>
<ul>
<?php
foreach(glob("site/blog/*.cfg.php") as $i)
{
include($i);
$entry_file = substr($i, 4, -8) . '.html';
echo "<li><a href='$entry_file'>$blog_date - $blog_title</a></li>";
}
?>
</ul>
<?php
include("templates/footer.html.php");
?>

View File

@ -0,0 +1,4 @@
<?php
$blog_title = "My First Post";
$blog_date = "2022-11-07";
?>

View File

@ -0,0 +1,9 @@
<?php
include("site/blog/000-first.cfg.php");
$title = $blog_title;
include("templates/header.html.php");
?>
<p>My first blog post.</p>
<?php
include("templates/footer.html.php");
?>

View File

@ -0,0 +1,10 @@
<?php
$title = "Home";
include("templates/header.html.php");
?>
<p>
Hello, World! This is an example page.
</p>
<?php
include("templates/footer.html.php");
?>

View File

@ -0,0 +1 @@
A test file.

View File

@ -0,0 +1,2 @@
</body>
</html>

View File

@ -0,0 +1,7 @@
<!DOCTYPE html>
<html>
<head>
<title><?= $title ?> | <?= $site_name?></title>
</head>
<body>
<h1><?= $title ?></h1>

View File

@ -26,6 +26,11 @@ ISIDORE_AUTHOR_NAME=""
PROG_NAME=$0
PROJECT_NAME="Isidore"
SOURCE_DIR="site/"
OUTPUT_DIR="output/"
TEMPLATE_DIR="templates/"
PROJECT_CONFIG_FILE="config.php"
##
# Create the configuration file. This function is called if it does not already
# exist.
@ -87,9 +92,11 @@ function print_help()
print_usage
echo -e "\nCOMMANDS:
new [-i] <dir>
Create a new Isidore project (use interactive mode with '-i')
build
Create a new Isidore project
build [-v] [-j<n>]
Build the project rooted in the current directory
serve | server [-p <port>]
Serve a local HTTP server of the output directory
clean
Clean the built files
version
@ -103,7 +110,7 @@ function print_help()
##
function check_in_project()
{
if ! [ -f "./config.php" ] || ! [ -f "./.isidore-version" ]
if ! [ -f "$PROJECT_CONFIG_FILE" ] || ! [ -f "./.isidore-version" ]
then
echo "ERROR: You are not currently in the root of an Isidore project."
exit 1
@ -121,9 +128,9 @@ function new_project()
{
echo "$PROJECT_NAME v$ISIDORE_VERSION"
NEW_PROJECT_DIR=$1
NEW_PROJECT_NAME="New Project"
NEW_PROJECT_URL="http://example.com/"
local NEW_PROJECT_DIR=$1
local NEW_PROJECT_NAME="New Project"
local NEW_PROJECT_URL="http://example.com/"
if [ $2 == 1 ]
then
echo -n "Project name: "
@ -132,19 +139,19 @@ function new_project()
read NEW_PROJECT_URL
fi
mkdir $NEW_PROJECT_DIR
mkdir -p $NEW_PROJECT_DIR/site/
mkdir -p $NEW_PROJECT_DIR/templates/
mkdir -p $NEW_PROJECT_DIR/$SOURCE_DIR
mkdir -p $NEW_PROJECT_DIR/$TEMPLATE_DIR
echo \
"<?php
\$site_name = \"$NEW_PROJECT_NAME\";
\$site_author = \"$ISIDORE_AUTHOR_NAME\";
\$site_url = \"$NEW_PROJECT_URL\";
?>" >> $NEW_PROJECT_DIR/config.php
?>" >> $NEW_PROJECT_DIR/$PROJECT_CONFIG_FILE
echo "$ISIDORE_VERSION" > $NEW_PROJECT_DIR/.isidore-version
echo "New project created."
[ $2 == 0 ] &&
echo "Consider taking a look at the $NEW_PROJECT_DIR/config.php file."
echo "Consider taking a look at the $NEW_PROJECT_DIR/$PROJECT_CONFIG_FILE file."
}
##
@ -153,43 +160,76 @@ function new_project()
function clean_project()
{
check_in_project
if [ -d "./output/" ]
if [ -d "$OUTPUT_DIR" ]
then
rm -r ./output/
rm -r $OUTPUT_DIR
fi
echo "Project cleaned."
}
##
# Build the project.
#
# Params:
# $1 - Verbose flag
# $2 - Maximum number of jobs to run
##
function build_project()
{
check_in_project
mkdir -p ./output/
WORKDESK="/tmp/isidore-workdesk"
CFG_HEADER_FILE="$WORKDESK/config-header.php"
mkdir -p $WORKDESK
for i in $(find site/ -name '*.php')
mkdir -p $OUTPUT_DIR
for i in $(find $SOURCE_DIR -type d)
do
echo "<?php include getcwd() . '/config.php'; ?>" > $CFG_HEADER_FILE
mkdir -p $WORKDESK/${i%/*}
cat $CFG_HEADER_FILE $i > $WORKDESK/$i
# the 4 offset is to avoid including `site/`
: ${i:4}
OUT_DIR="./output/${_%/*}"
mkdir -p $OUT_DIR
: ${i: :-4}
OUT_FILE="$OUT_DIR/${_##*/}"
php $WORKDESK/$i > $OUT_FILE
mkdir -p $OUTPUT_DIR/${i:${#SOURCE_DIR}}
done
rm -r $WORKDESK
# number of current jobs
local NUM_JOBS="\j"
for i in $(find site -type f -regextype posix-extended -not -regex '.*\.(cfg|CFG)\.(php|PHP)')
do
while (( $2 != 0 )) && (( ${NUM_JOBS@P} >= $2 ))
do
wait -n
done
# parallel block
(
if [[ $i =~ .*\.(php|PHP) ]]
then
: ${i:${#SOURCE_DIR}}
local OUT_FILE="$OUTPUT_DIR/${_: :-4}"
if [ $1 == 1 ]
then
echo "Building $OUT_FILE ..."
fi
cat $PROJECT_CONFIG_FILE $i | php > $OUT_FILE
else
local OUT_FILE="$OUTPUT_DIR/${i:${#SOURCE_DIR}}"
if [ $1 == 1 ]
then
echo "Copying $OUT_FILE ..."
fi
cp $i $OUT_FILE
fi
) &
done
# wait for jobs to finish
wait -n
}
set_config_vars
if [ $# -lt 1 ]
then
echo "No subcommand was specified. Use the 'help' subcommand."
print_usage
exit 1
fi
case $1 in
new)
if [ $# -lt 2 ]
@ -210,15 +250,59 @@ case $1 in
then
NEW_DIR="$i"
else
echo "Unknown argument for new '$i'. Use the 'help' command."
echo "Unknown argument for new '$i'. Use the 'help' subcommand."
print_usage
exit 1
fi
fi;;
esac
done
new_project $NEW_DIR $INTERACTIVE;;
build)
build_project;;
VERBOSE=0
JOBS=1
for i in ${@:2}
do
case $i in
-v)
VERBOSE=1;;
-j*)
if ! [[ "$i" =~ ^-j[0-9]+$ ]]
then
echo "Argument '$i' badly formatted. Should be '-j<n>' where <n> is a number."
print_usage
exit 1
fi
JOBS=${i:2};;
*)
echo "Unknown argument for build '$i'. Use the 'help' subcommand."
print_usage
exit 1;;
esac
done
build_project $VERBOSE $JOBS;;
serve|server)
PORT=8080
shift
while getopts "p:" opt
do
case $opt in
p)
if ! [[ "$OPTARG" =~ ^[0-9]+$ ]]
then
echo "Invalid port $OPTARG. Please enter a number."
exit 1
fi
PORT=$OPTARG;;
?)
echo "Invalid argument $OPTARG. Use the 'help' subcommand."
print_usage
exit 1;;
:)
echo "Option -$OPTARG requires an argument."
exit 1;;
esac
done
php -S localhost:$PORT -t $OUTPUT_DIR/;;
clean)
clean_project;;
help)
@ -226,7 +310,7 @@ case $1 in
version)
echo "$PROJECT_NAME v$ISIDORE_VERSION";;
*)
echo "Unknown command $1. Use the 'help' command."
echo "Unknown command $1. Use the 'help' subcommand."
print_usage
exit 1;;
esac