You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@jena.apache.org by "kinow (via GitHub)" <gi...@apache.org> on 2023/04/09 13:44:26 UTC

[GitHub] [jena-site] kinow opened a new pull request, #155: Layout and formatting improvements

kinow opened a new pull request, #155:
URL: https://github.com/apache/jena-site/pull/155

   I am reading about SHACL and ShEx, and noticed that these pages were not displaying code using Hugo's code highlighter. (before & after screenshots)
   
   Applied the three-backticks to format code to SHACL, ShEx, RDFS, and RDF Connection pages.
   
   ![image](https://user-images.githubusercontent.com/304786/230776054-94039a96-da9b-482e-9cfc-cbe54c13ddd7.png)
   
   ![image](https://user-images.githubusercontent.com/304786/230776065-e390ddaf-3046-46a3-a625-95d3c3f49fb5.png)
   
   I use a large monitor, but organize windows side-by-side, and noticed that the top menu was broken for 
   
   ![image](https://user-images.githubusercontent.com/304786/230775987-71f1f1f7-9fea-4d69-aa40-9f1bb39f7f6b.png)
   
   ![image](https://user-images.githubusercontent.com/304786/230775997-2b0a50f0-8a0f-4f29-81dc-a1501ab2f474.png)
   
   Finally, also noticed that the dropdown z-index fix I tried some time ago is not working. Added `!important` to the css statement and it appears to be fixed now.
   
   ![image](https://user-images.githubusercontent.com/304786/230776194-4e1c8006-6f97-45e5-969d-b294680ecac0.png)
   
   ![image](https://user-images.githubusercontent.com/304786/230776204-1ad76367-9ef9-4b6b-a897-40327b39c0a2.png)
   
   Happy to squash commits, or drop commits if needed :+1: 
   
   Thanks!


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [jena-site] kinow merged pull request #155: Layout and formatting improvements

Posted by "kinow (via GitHub)" <gi...@apache.org>.
kinow merged PR #155:
URL: https://github.com/apache/jena-site/pull/155


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [jena-site] afs commented on a diff in pull request #155: Layout and formatting improvements

Posted by "afs (via GitHub)" <gi...@apache.org>.
afs commented on code in PR #155:
URL: https://github.com/apache/jena-site/pull/155#discussion_r1161329933


##########
source/documentation/shex/__index.md:
##########
@@ -6,11 +6,8 @@ slug: index
 `jena-shex` is an implementation of the 
 [ShEx (Shape Expressions)](https://shex.io) language.
 
-<p>
-<i>This implementation is experimental, starting with Jena 4.2.0.
-Please send usage reports and experience to </i>
-<tt>users@jena.apache.org</tt>.
-</p>
+> NOTE: This implementation is experimental, starting with Jena 4.2.0.
+> Please send usage reports and experience to <tt>users@jena.apache.org</tt>.

Review Comment:
   This can be removed now it's 4.7.0. ShEx is complete.



##########
source/documentation/rdfs/__index.md:
##########
@@ -137,7 +139,7 @@ curl --data @query.rq \
 
 will return:
 
-```
+```sparql

Review Comment:
   sparql syntax doesn't apply to the test format results.



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [jena-site] kinow commented on a diff in pull request #155: Layout and formatting improvements

Posted by "kinow (via GitHub)" <gi...@apache.org>.
kinow commented on code in PR #155:
URL: https://github.com/apache/jena-site/pull/155#discussion_r1161337311


##########
source/documentation/shex/__index.md:
##########
@@ -6,11 +6,8 @@ slug: index
 `jena-shex` is an implementation of the 
 [ShEx (Shape Expressions)](https://shex.io) language.
 
-<p>
-<i>This implementation is experimental, starting with Jena 4.2.0.
-Please send usage reports and experience to </i>
-<tt>users@jena.apache.org</tt>.
-</p>
+> NOTE: This implementation is experimental, starting with Jena 4.2.0.
+> Please send usage reports and experience to <tt>users@jena.apache.org</tt>.

Review Comment:
   Removed (I left the CSS styles for notes)



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [jena-site] afs commented on pull request #155: Layout and formatting improvements

Posted by "afs (via GitHub)" <gi...@apache.org>.
afs commented on PR #155:
URL: https://github.com/apache/jena-site/pull/155#issuecomment-1501196740

   GPLv3 is probably not possible because it's be a dependency on `jena-site` like a GPL dependency on code would be.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [jena-site] kinow commented on pull request #155: Layout and formatting improvements

Posted by "kinow (via GitHub)" <gi...@apache.org>.
kinow commented on PR #155:
URL: https://github.com/apache/jena-site/pull/155#issuecomment-1501674351

   Saw a discussion today about federated queries and had a look at our docs for that. Noticed that some links were not displayed correctly on the ARQ queries page so fixed that
   
   ![image](https://user-images.githubusercontent.com/304786/230888194-a925fd1f-f0a7-4f2a-9567-310ba368e18b.png)
   
   ![image](https://user-images.githubusercontent.com/304786/230888253-aa58cedd-43cf-4bce-8739-d09d25b3609b.png)
   
   The page about ARQ federated service had no syntax highlight, so I enabled that (used SPARQL for both query & algebra - I tried lisp, but it got all yellow, and the sparql output produced clearer output I think? although some entries are not highlighted...)
   
   ![image](https://user-images.githubusercontent.com/304786/230888332-59996993-a404-4b1c-9151-520f0e4a1ea6.png)
   
   ![image](https://user-images.githubusercontent.com/304786/230888440-012f68cd-d12c-498c-8243-e8c6f8b8ecec.png)
   
   One final change to make tables look more consistent (same width, titles with a little padding):
   
   ![image](https://user-images.githubusercontent.com/304786/230888564-2bcb74c3-63da-43a1-96d3-f9107b1c57a8.png)
   
   ![image](https://user-images.githubusercontent.com/304786/230888603-c6dee83f-8f06-4f24-bd9c-487449dbabba.png)
   
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [jena-site] kinow commented on pull request #155: Layout and formatting improvements

Posted by "kinow (via GitHub)" <gi...@apache.org>.
kinow commented on PR #155:
URL: https://github.com/apache/jena-site/pull/155#issuecomment-1501132952

   Oh, almost forgot. I added some `blockquote` style, so that we can use the Markdown `>` to add an admonition (those alert boxes, like NOTE, WARNING, TIP), but without handling different types (i.e. it's a gray box with the text inside for now).
   
   I was going to use this Hugo add-on: https://github.com/martignoni/hugo-notice
   
   But that uses GPLv3, and I wasn't sure if it'd be OK to add that, or if we would have to add a `NOTICE` file. So went with the simplest approach for now. That's to replace some text that was appearing in italic only, in the ShEx page.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [jena-site] kinow commented on pull request #155: Layout and formatting improvements

Posted by "kinow (via GitHub)" <gi...@apache.org>.
kinow commented on PR #155:
URL: https://github.com/apache/jena-site/pull/155#issuecomment-1501208355

   >GPLv3 is probably not possible because it's be a dependency on jena-site like a GPL dependency on code would be.
   
   Makes sense, better to write our own little addon (shouldn't be too hard, just need time to remember how to write shortcodes and test).
   
   Thanks for the review!


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org


[GitHub] [jena-site] kinow commented on a diff in pull request #155: Layout and formatting improvements

Posted by "kinow (via GitHub)" <gi...@apache.org>.
kinow commented on code in PR #155:
URL: https://github.com/apache/jena-site/pull/155#discussion_r1161337609


##########
source/documentation/rdfs/__index.md:
##########
@@ -137,7 +139,7 @@ curl --data @query.rq \
 
 will return:
 
-```
+```sparql

Review Comment:
   I removed the sparql syntax bit :+1: 



-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: dev-unsubscribe@jena.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org