gitoria

2.4 KB

1. // lib/homepage.hl — THE REPO HOMEPAGE (ticket gitoria#8; the creator, ticket #1): the repo's `/` shows README.md as a page;
2. // if there is a `$docs` folder, all Markdown files inside it form the homepage instead. Read from the repo's main
3. // branch (the owner's setting, git.hl defaultBranch) while the page is built on the server (homepageNow).
4. import { NL } from './util.hl'
5. import { git, defaultBranch, maxTree } from './git.hl'
6. import { safePath } from './git-helpers.hl'
7. import { markdownBlocks } from './markdown.hl'
9. static maxFiles = 30 // Markdown files of a $docs folder
10. static maxLines = 5000 // lines of one file
12. // the homepage of a repo, SYNCHRONOUSLY (git() calls back before it returns): what the Readme page's root uses
13. static homepageNow = (slug, setting) => {
14. let out = { files = [] found = false truncated = false }
15. defaultBranch(slug, setting, (ref) => {
16. loadHomepage(slug, ref, (result) => {
17. out = result
18. return null
19. })
20. return null
21. })
22. return out
23. }
25. static isMarkdown = (path) => { return path.toLowerCase().endsWith('.md') }
27. // the files that make the homepage: [] (none), or the paths in tree order
28. static homepagePaths = (tree) => {
29. docs = []
30. let readme = null
31. for (path of tree) {
32. if (safePath(path)) {
33. if (path.startsWith('$docs/') && isMarkdown(path) && docs.length < maxFiles) { docs.push(path) }
34. if (readme == null && !path.includes('/') && path.toLowerCase() == 'readme.md') { readme = path }
35. }
36. }
37. if (docs.length > 0) { return docs }
38. return readme != null ? [readme] : []
39. }
41. // the homepage of a branch (its ref) → done({ files: [{ path, isDocs, blocks }], found, truncated })
42. static loadHomepage = (slug, ref, done) => {
43. if (ref == null) {
44. done({ files = [] found = false truncated = false })
45. return null
46. }
47. git(slug, ['ls-tree', '-r', '--name-only', ref], maxTree, (t) => {
48. paths = t.ok ? homepagePaths(t.lines) : []
49. let files = []
50. let truncated = false
51. next = (i) => {
52. if (i >= paths.length) {
53. done({ files = files found = files.length > 0 truncated = truncated })
54. return null
55. }
56. git(slug, ['cat-file', 'blob', ref + ':' + paths[i]], maxLines + 1, (r) => {
57. if (r.ok) {
58. if (r.lines.length > maxLines) { truncated = true }
59. lines = r.lines.length > maxLines ? r.lines.slice(0, maxLines) : r.lines
60. files.push({ path = paths[i] isDocs = paths[i].startsWith('$docs/') blocks = markdownBlocks(lines.join(NL)) })
61. }
62. next(i + 1)
63. return null
64. })
65. return null
66. }
67. next(0)
68. return null
69. })
70. }